CodeGeeX-4
CodeGeeX4 は、コード生成、補完、説明、修復、リポジトリに関する質問のための、多言語コーディングモデルファミリーです。ネイティブのガイドは、タスク別のプロンプト、既存コードの間の空白を埋める方法、関連ファイルを使って明示的なファイルパス付きの変更を準備する方法を扱っています。
- Ailoot Ultra · OpenAI チャット
POST /v1/chat/completionscodegeex-4 - Ailoot Ultra · Anthropic メッセージ
POST /v1/messagescodegeex-4
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
CodeGeeX4 は、プログラミング支援と関連するソースファイルをまたぐ作業を中心に構築された、多言語コーディングモデルファミリーです。メーカーは、GLM-4-9B の継続訓練によって開発した CodeGeeX4-ALL-9B を、シリーズのオープンソースモデルとして公開しています。文書では、コード生成と補完、プログラミングに関する質問、リポジトリ分析、コードインタープリター、ウェブ検索、関数呼び出しを伴う接続ワークフローを扱っています。通常の出力はテキストです。タスク指示に応じて、コード、説明、回答、ファイルラベル付きの変更を返します。
まず操作を選び、必要なコードをモデルに渡します。ネイティブのシステムプロンプトガイドには、コメント追加、プログラム説明、プログラミング言語間の翻訳、コードレビューや修復、テスト生成、ファイルに関する質問への回答について、個別の指示があります。修復では、失敗するコード、観測された動作、意図した結果を含めます。翻訳では、対象のプログラミング言語を示し、関連する関数を完全な形で渡します。コメント追加のタスク指示では、元のコードを保ってコメントを追加します。コードを生成する複数のタスクでは、コードのみを求めています。これらの区別は、出力形式を暗黙にせず、コード成果物や説明として使える結果にするために役立ちます。
ガイドには、中国語と英語のシステムプロンプトが用意されています。システム指示の言語だけで回答言語が決まるわけではないため、説明が必要な場合は回答言語を明示します。専用のレビュー指針は中国語出力を説明しています。汎用のプログラミングアシスタント用プロンプトは、別の言語でレビューを求めるための別の方法を提供します。一部のタスクテンプレートは、コメントの言語をソースに合わせ、中国語と英語の混在出力を避けるよう指定しています。継続中の対話で操作を切り替えるときは、関連するタスク指示を再提示し、説明の依頼が、それ以前のコードのみを求める依頼と混同されないようにしてください。
文脈を使う補完では、ネイティブ形式で対象ファイル、プログラミング言語、挿入位置の前後のコードを記述します。###PATH: で相対ファイルパスを指定し、###LANGUAGE: を含めます。ガイドでは、言語が不明な場合は言語値を空にできます。###MODE: は、1行の補完には LINE、複数行には BLOCK を選び、文書化された既定値は BLOCK です。途中を埋めるシーケンスは、まず後半、次に前半、最後に欠けた中間部分の順で、<|code_suffix|>、<|code_prefix|>、<|code_middle|> のマーカーを使います。メーカーの穴埋めテンプレートには、システムプロンプトを含めません。後半を保持すると、挿入後にも残すべき制御フローとコードをモデルへ渡せます。結果は、欠けたコードの提案であり、元の位置に戻して確認できます。
複数ファイルの補完では、関連する断片を参考資料として追加し、それぞれに ###REFERENCE: と固有の ###PATH: を付けます。これらの参照は、対象ファイルと挿入位置とは分けてください。例えば、既存のヘルパーを呼び出す関数を補完する場合は、そのヘルパーのシグネチャと実装を、対象関数の前半・後半とともに提供します。プロジェクト単位の補完ガイドは、この方法を、プロジェクト要件と関連する既存コードから新しいファイルを生成する作業に拡張しています。明確なパスと選び出した依存コードにより、根拠として提供したコードと、モデルに補完を求めるファイルを区別できます。
リポジトリの質問には、別のネイティブな配置を使います。各ファイルを ###PATH: の下に列挙し、そのコードを含めてから質問します。有用な依頼では、値がどこで定義されているか、提供したモジュール間で呼び出しがどう受け渡されるかを尋ねられます。リポジトリ編集では、ファイルの追加、削除、変更のための専用システム指示を使い、###PATH: {PATH} の後にコードを続ける形式で出力を求めます。関連ファイルを準備し、追加するファイルや保持すべき動作を含め、必要な変更を説明します。返されたパス付きブロックは、変更案として読んでください。すでにリポジトリが変更されたことや、コードが実行されたことの根拠ではありません。
公開された CodeGeeX4-ALL-9B について、メーカーは 128K のコンテキストを文書化し、プロジェクトがそのウィンドウを超える場合は、関連するリポジトリ内容を選ぶよう推奨しています。関連する断片の検索と、大きすぎる入力の削減は、リポジトリガイドの準備工程です。コンテキストには、指示、提供コード、生成される続きのすべてを収める必要があります。そのため、区別のないプロジェクト全体のダンプより、対象を絞ったファイル群の方が有用なことがよくあります。メーカーの生成設定例は、特定の実行の長さを制御するもので、すべての CodeGeeX4 エディションに共通する最大回答長を定めるものではありません。
シリーズでは、インタープリター、検索、関数呼び出しを使う接続されたプログラミングワークフローも説明しています。このようなワークフローには、周辺のアプリケーションが指定ツールを提供し、結果を対話へ返す必要があります。実行可能なコードを求める場合は、想定言語、依存関係、期待する動作を示します。分析を求める場合は、関連するファイルや関数の参照を求めます。プロジェクトへ組み込む前に、意図した環境で変更案をコンパイルまたは実行し、提供した要件に照らして動作を確認します。
Ailoot Ultra · OpenAI チャット POST /v1/chat/completions codegeex-4
codegeex-4はじめに
CodeGeeX4 は、コード生成、補完、説明、修復、リポジトリに関する質問のための、多言語コーディングモデルファミリーです。ネイティブのガイドは、タスク別のプロンプト、既存コードの間の空白を埋める方法、関連ファイルを使って明示的なファイルパス付きの変更を準備する方法を扱っています。
- 対応する入力
- テキスト
- 結果
- テキスト
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · OpenAI チャット 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 チャット
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 チャット
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 メッセージ POST /v1/messages codegeex-4
codegeex-4はじめに
CodeGeeX4 は、コード生成、補完、説明、修復、リポジトリに関する質問のための、多言語コーディングモデルファミリーです。ネイティブのガイドは、タスク別のプロンプト、既存コードの間の空白を埋める方法、関連ファイルを使って明示的なファイルパス付きの変更を準備する方法を扱っています。
- 対応する入力
- テキスト
- 結果
- json · sse
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · Anthropic メッセージ 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 メッセージ
{
"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 メッセージ
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