CodeGeeX-4
CodeGeeX4는 코드 생성, 완성, 설명, 수정, 저장소 질문을 위한 다국어 코딩 모델 계열입니다. 네이티브 가이드는 작업별 프롬프트, 기존 코드 사이의 빈 부분 채우기, 명시적인 파일 경로와 관련 파일을 사용한 변경 준비를 다룹니다.
- Ailoot Ultra · OpenAI Chat
POST /v1/chat/completionscodegeex-4 - Ailoot Ultra · Anthropic Messages
POST /v1/messagescodegeex-4
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
CodeGeeX4는 프로그래밍 지원과 관련 소스 파일 전반의 작업을 중심으로 구축한 다국어 코딩 모델 계열입니다. 제작사는 GLM-4-9B의 지속 훈련으로 개발한 CodeGeeX4-ALL-9B를 이 시리즈의 오픈소스 모델로 공개합니다. 문서는 코드 생성 및 완성, 프로그래밍 질문, 저장소 분석, 코드 인터프리터·웹 검색·함수 호출이 연결된 워크플로를 다룹니다. 일반 출력은 작업 지침에 따른 텍스트이며, 코드, 설명, 답변, 파일 이름이 표시된 변경 사항이 될 수 있습니다.
먼저 작업을 선택하고 모델에 필요한 코드를 제공하세요. 네이티브 시스템 프롬프트 가이드는 주석 추가, 프로그램 설명, 프로그래밍 언어 간 번역, 코드 검토 또는 수정, 테스트 생성, 파일에 관한 질문에 대해 별도 지침을 제공합니다. 수정에서는 실패하는 코드, 관찰한 동작, 의도한 결과를 포함하세요. 번역에서는 대상 프로그래밍 언어를 명시하고 관련 함수 전체를 제공하세요. 주석 작업에서는 제작사의 작업 지침이 코드를 보존하고 주석을 추가합니다. 여러 코드 생성 작업에서는 코드만 요청합니다. 이러한 구분은 출력 형식을 암묵적으로 남겨두는 대신 결과를 코드 결과물이나 설명으로 사용할 수 있게 합니다.
가이드는 중국어와 영어 시스템 프롬프트를 제공합니다. 시스템 지침의 언어만으로 답변 언어가 결정되지는 않으므로 설명이 필요하면 응답 언어를 명시적으로 요청하세요. 특화된 검토 지침은 중국어 출력을 설명하며, 일반 프로그래밍 어시스턴트 프롬프트는 다른 언어로 검토를 요청할 별도 방법을 제공합니다. 일부 작업 템플릿은 주석 언어를 원본과 일치시키고 중국어와 영어가 섞인 출력을 제외합니다. 이어지는 대화에서 작업을 바꿀 때는 관련 작업 지침을 다시 제시해 설명 요청이 앞선 코드 전용 출력 요청과 혼동되지 않도록 하세요.
문맥 기반 코드 완성에서 네이티브 형식은 대상 파일, 프로그래밍 언어, 삽입 지점 양쪽의 코드를 설명합니다. ###PATH:에 상대 파일 경로를 쓰고 ###LANGUAGE:를 포함하세요. 가이드는 언어를 모를 때 언어 값을 비워둘 수 있게 합니다. ###MODE:는 한 줄 완성에 LINE, 여러 줄 완성에 BLOCK을 선택하며, 문서상 기본값은 BLOCK입니다. 중간 채우기 순서는 먼저 접미부, 다음 접두부, 마지막으로 누락된 중간 부분이며, 각각 <|code_suffix|>, <|code_prefix|>, <|code_middle|>로 표시합니다. 제작사의 채우기 템플릿에는 시스템 프롬프트가 없습니다. 접미부를 유지하면 모델에 주변 제어 흐름과 삽입 후에도 남아야 할 코드를 제공할 수 있습니다. 결과는 제안된 누락 코드이며 원래 위치에서 확인할 수 있습니다.
파일 간 완성은 관련 코드 조각을 참고 자료로 추가하며, 각 조각은 ###REFERENCE:와 자체 ###PATH:로 시작합니다. 이 참조를 대상 파일 및 삽입 지점과 구분하세요. 예를 들어 기존 헬퍼를 호출하는 함수를 완성할 때는 대상 함수의 접두부와 접미부와 함께 헬퍼의 시그니처 및 구현을 제공하세요. 프로젝트 수준 완성 가이드는 이 접근을 프로젝트 요구 사항과 관련 기존 코드로 새 파일을 생성하는 작업으로 확장합니다. 명확한 경로와 선택한 의존 관계를 통해 근거로 제공한 코드와 모델에 완성을 요청한 파일을 구분할 수 있습니다.
저장소 질문은 다른 네이티브 배치를 사용합니다. 각 파일을 ###PATH: 아래에 나열하고 코드를 포함한 뒤 질문하세요. 값이 어디에 정의되는지, 제공한 모듈 사이에서 호출이 어떻게 전달되는지 물을 수 있습니다. 저장소 편집은 파일 추가, 삭제, 수정을 위한 자체 시스템 지침을 사용하며, ###PATH: {PATH} 다음에 코드를 출력하도록 요청합니다. 관련 파일을 준비하고 추가할 파일이나 유지할 동작을 포함해 필요한 변경을 설명하세요. 반환된 경로 표시 블록은 제안된 변경입니다. 저장소가 이미 수정되었거나 코드가 실행되었다는 근거는 아닙니다.
공개된 CodeGeeX4-ALL-9B 모델에 대해 제작사는 128K 컨텍스트를 문서화하며, 프로젝트가 그 창을 초과하면 관련 저장소 내용을 선택하도록 권장합니다. 관련 코드 조각 검색과 너무 큰 입력 축소는 저장소 가이드의 준비 단계입니다. 컨텍스트에는 지침, 제공한 코드, 생성된 후속 코드가 들어가야 하므로 구분 없는 프로젝트 전체 덤프보다 대상이 분명한 파일 집합이 더 유용한 경우가 많습니다. 제작사의 생성 설정 예시는 특정 실행의 길이를 제어하며, 모든 CodeGeeX4 에디션의 보편적인 최대 답변 길이를 정의하지 않습니다.
이 시리즈는 인터프리터, 검색, 함수 호출을 사용하는 연결된 프로그래밍 워크플로도 설명합니다. 이러한 워크플로에는 주변 애플리케이션이 지정된 도구를 제공하고 결과를 대화에 반환해야 합니다. 실행 가능한 코드를 요청할 때는 목표 언어, 의존성, 기대 동작을 명시하세요. 분석을 요청할 때는 관련 파일이나 함수 참조를 요청하세요. 제안된 변경을 의도한 환경에서 컴파일하거나 실행하고, 프로젝트에 반영하기 전에 제공한 요구 사항과 동작을 대조하세요.
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions codegeex-4
codegeex-4시작하기
CodeGeeX4는 코드 생성, 완성, 설명, 수정, 저장소 질문을 위한 다국어 코딩 모델 계열입니다. 네이티브 가이드는 작업별 프롬프트, 기존 코드 사이의 빈 부분 채우기, 명시적인 파일 경로와 관련 파일을 사용한 변경 준비를 다룹니다.
- 허용 입력
- 텍스트
- 결과
- 텍스트
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · OpenAI Chat POST /v1/chat/completions
- 입력
text- 출력
text- 출력 형식
- json 또는 SSE
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 codegeex-4 | 기본값— |
필드messages | 유형message[] | 요건필수 | 값과 한도 최소 항목 수: 1 | 기본값— |
필드messages[].role | 유형string | 요건필수 | 값과 한도 모델에 따라 다름 | 기본값— |
필드messages[].content | 유형string | 요건선택 사항 | 값과 한도 적용 조건: 텍스트 대화 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값false |
입력 자료 조합
텍스트 · UTF8 텍스트
messages[].content
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, messages |
매개변수material_types | 명세text |
매개변수messages | 명세role/content 형식의 메시지 배열 |
매개변수file_material | 명세실제 UTF-8 문서를 텍스트로 그대로 삽입합니다. 파일 ID는 추정하지 않습니다 |
매개변수optional_controls | 명세stream |
매개변수control_scope | 명세텍스트 대화. stream은 불리언이며 기본값은 false입니다. |
매개변수output_modalities | 명세text |
매개변수hosted_operations | 명세false |
매개변수multimodal_input_binding | 명세null |
메서드 별칭: /chat/completions
수명 주기: synchronous_or_streamed
정확한 모델 ID를 messages와 함께 보내세요.
컨텍스트 길이는 출력 상한이 아닙니다.
텍스트 파일은 텍스트를 그대로 제공할 수 있습니다. 이미지/오디오/파일 객체 입력에는 정확한 바인딩이 필요합니다.
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
| 설정 | 요금표 | 요금 |
|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 요금 입력 · 입력 토큰 $0.028 / 1K 토큰 출력 · 출력 토큰 $0.028 / 1K 토큰 입력 · 캐시 읽기 $0 / 1K 토큰 입력 · 캐시 쓰기 $0 / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · OpenAI Chat
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"codegeex-4","messages":[{"role":"user","content":"hello"}],"stream":false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os
if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="codegeex-4", messages=[{"role":"user","content":"hello"}], stream=False)
import base64, json
from pathlib import Path
def save_result(data, stem="result"):
# Keep every field, including usage, IDs, reasoning and tool requests.
Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
def save_blob(encoded, suffix, label):
raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
file = Path(stem + "-" + label + "." + ext)
file.write_bytes(raw)
print("Saved", file)
for index, block in enumerate(data.get("content") or []):
print("Content", index, json.dumps(block, ensure_ascii=False))
for choice in data.get("choices") or []:
print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
for index, item in enumerate(data.get("output") or []):
print("Output", index, json.dumps(item, ensure_ascii=False))
if item.get("type") == "image_generation_call" and item.get("result"):
save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
for ci, candidate in enumerate(data.get("candidates") or []):
for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
blob = part.get("inlineData") or part.get("inline_data")
if blob and blob.get("data"):
mime = blob.get("mimeType") or blob.get("mime_type")
suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))
save_result(result.to_dict(mode="json"))
결과 수신 및 저장
Ailoot Ultra · OpenAI Chat
json 또는 SSE
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
각 선택지와 그 콘텐츠·도구 호출·추론을 모두 보존하세요. SSE에서는 선택지/도구 인덱스별로 증분을 조합하고 최종 종료 사유와 사용량을 유지하세요.
원래 응답을 확인해야 할 경우
요청/응답 ID와 헤더를 보존하세요. 텍스트 작업을 조회하는 범용 URL은 제공되지 않습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드choices[].index | 유형integer |
필드choices[].message.content | 유형string|null |
필드choices[].message.tool_calls | 유형tool_call[] |
필드choices[].message.reasoning_content | 유형string |
필드choices[].message.reasoning_details | 유형object|array |
필드choices[].finish_reason | 유형string|null |
필드usage | 유형object |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
별칭
모델 별칭
Ailoot Ultra codegeex-4
메서드 경로 별칭
/chat/completions
관련 호출용 ID
Ailoot Ultra · Anthropic Messages POST /v1/messages codegeex-4
codegeex-4시작하기
CodeGeeX4는 코드 생성, 완성, 설명, 수정, 저장소 질문을 위한 다국어 코딩 모델 계열입니다. 네이티브 가이드는 작업별 프롬프트, 기존 코드 사이의 빈 부분 채우기, 명시적인 파일 경로와 관련 파일을 사용한 변경 준비를 다룹니다.
- 허용 입력
- 텍스트
- 결과
- json · sse
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Anthropic Messages POST /v1/messages
- 입력
text- 출력
json,sse- 출력 형식
- JSON 또는 SSE
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 codegeex-4 | 기본값— |
필드messages | 유형message[] | 요건필수 | 값과 한도 | 기본값— |
필드messages[].role | 유형string | 요건필수 | 값과 한도 user, assistant | 기본값— |
필드messages[].content | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드max_tokens | 유형integer | 요건필수 | 값과 한도 | 기본값— |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값false |
입력 자료 조합
텍스트 · UTF-8 텍스트
messages[].content 문자열
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, messages, max_tokens |
매개변수optional_controls | 명세stream |
매개변수material_types | 명세text |
매개변수text_file_material | 명세실제 UTF-8 문서를 읽고 그 텍스트를 지정된 입력 또는 메시지 콘텐츠 문자열에 넣으세요. |
수명 주기: synchronous_or_streamed
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
| 설정 | 요금표 | 요금 |
|---|---|---|
| 설정토큰의 기본 단가 | 요금표기본 요금 | 요금 입력 · 입력 토큰 $0.028 / 1K 토큰 출력 · 출력 토큰 $0.028 / 1K 토큰 입력 · 캐시 읽기 $0 / 1K 토큰 입력 · 캐시 쓰기 $0 / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Anthropic Messages
{
"model": "codegeex-4",
"max_tokens": 128,
"messages": [
{
"role": "user",
"content": "Summarize the incident report."
}
],
"stream": false
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'codegeex-4', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
-H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path
source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
raise SystemExit('Choose a document containing text')
payload = {'model': 'codegeex-4', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError
api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
with urlopen(request, timeout=120) as response:
raw = response.read()
Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
Path('result.json').write_bytes(error.read())
Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path
result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
결과 수신 및 저장
Ailoot Ultra · Anthropic Messages
JSON 또는 SSE
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
모든 콘텐츠 블록, 사고 서명, 실제 도구 사용 ID를 보존하세요. 모든 SSE 블록 증분을 조합하세요. 첫 텍스트 블록이 전체 출력은 아닙니다.
원래 응답을 확인해야 할 경우
요청/응답 ID와 헤더를 보존하세요. 텍스트 작업을 조회하는 범용 URL은 제공되지 않습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드id | 유형string |
필드model | 유형string |
필드content[] | 유형text|thinking|tool_use|other content block |
필드stop_reason | 유형string|null |
필드usage | 유형object |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
별칭
모델 별칭
Ailoot Ultra codegeex-4
메서드 경로 별칭
/chat/completions
관련 호출용 ID
FAQ · CodeGeeX-4
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/chat/completions·codegeex-4:text→textPOST /v1/messages·codegeex-4:text→json,sse- 요청은 어떤 필드를 사용하나요?
POST /v1/chat/completions·codegeex-4:model,messages,streamPOST /v1/messages·codegeex-4:model,messages,max_tokens,stream- 어떤 제한이 적용되나요?
POST /v1/chat/completions·codegeex-4:messages.min_items:1