Chat Completions

チャット補完は最もよく使われるインターフェースで、OpenAI プロトコルと完全に互換です。

POST https://api.4allapi.com/v1/chat/completions

リクエストパラメータ

パラメータ	型	必須	説明
`model`	string	はい	モデル名、モデル一覧を参照
`messages`	array	はい	対話メッセージ配列、要素に `role` と `content` を含む
`stream`	boolean	いいえ	ストリーミング返却するか、ストリーミング出力を参照
`temperature`	number	いいえ	サンプリング温度 0–2、値が大きいほど発散しやすい
`top_p`	number	いいえ	nucleus sampling の閾値、temperature とどちらか一方を調整
`max_tokens`	number	いいえ	応答の最大 token 数
`stop`	string/array	いいえ	停止語
`presence_penalty`	number	いいえ	話題の新規性ペナルティ -2–2
`frequency_penalty`	number	いいえ	繰り返しペナルティ -2–2
`tools`	array	いいえ	ツール/関数呼び出し定義（対応モデル）
`response_format`	object	いいえ	例: `{"type":"json_object"}` で JSON 出力を強制

messages の role は system / user / assistant / tool をサポートします。 content は文字列でも、多モーダル配列（テキスト + 画像、視覚理解を参照）でも構いません。

リクエスト例

curl https://api.4allapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "fable-5",
    "messages": [
      {"role": "system", "content": "あなたは厳密な技術アシスタントです"},
      {"role": "user", "content": "API ゲートウェイとは何かを一文で説明してください"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

レスポンス構造

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1750000000,
  "model": "fable-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "API ゲートウェイは……" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 41,
    "total_tokens": 73
  }
}

usage フィールドは課金の根拠です、詳細は課金と利用枠を参照してください。