テキストGPTGPT-5.2

GPT-5.2 - 完全なAPIリファレンス

OpenAI SDK形式でGPT-5.2モデルを呼び出し

同期処理モード、リアルタイムレスポンス
テキスト会話: シングルターンまたはマルチターンのコンテキスト対話
システムプロンプト: AIのロールと動作をカスタマイズ
マルチモーダル入力: テキスト+画像の混合入力をサポート
クイックスタートはクイックスタートガイドをご確認ください

<Note> **BaseURL**：デフォルトの BaseURL は `https://api.starmagic.ai` で、テキストモデルへの対応が優れており、長時間接続をサポートします。`https://api.starmagic.ai` はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。 </Note>

認証

Authorizationstringheader必須

## すべてのAPIにBearer Token認証が必要です ## **APIキーの取得：** [APIキー管理ページ](https://starmagic.ai/app/api-keys)にアクセスしてAPIキーを取得してください **リクエストヘッダーに追加：** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

リクエストボディ

application/json

modelenum<gpt-5.2>必須

チャット補完用モデル名

"gpt-5.2"

messagesobject[]必須

会話用メッセージリスト、マルチターン対話とマルチモーダル入力（テキスト、画像）をサポート

[
  {
    "role": "user",
    "content": [
      null
    ]
  }
]

streamboolean

レスポンスをストリーミングするかどうか - `true`: ストリームレスポンス、リアルタイムでチャンク単位にコンテンツを返却 - `false`: 完全なレスポンスを待って一括で返却

false

temperaturenumber

サンプリング温度、出力のランダム性を制御 **注意**: - 低い値（例: 0.2）: より決定的で集中した出力 - 高い値（例: 1.5）: よりランダムで創造的な出力

0.7

top_pnumber

Nucleus samplingパラメータ **注意**: - 累積確率に基づくトークンサンプリングを制御 - 例えば、0.9は累積確率上位90%のトークンからサンプリングすることを意味します - デフォルト: 1.0（全トークンを考慮） **推奨**: temperatureとtop_pを同時に調整しないでください

0.9

top_kinteger

Top-Kサンプリングパラメータ **注意**: - 例えば、10は各サンプリングステップで最も確率の高い上位10トークンのみを考慮することを意味します - 小さい値は出力をより集中させます - デフォルト: 無制限

レスポンス

application/json

成功

レスポンスボディ

idstring

チャット補完の一意の識別子

"chatcmpl-20251010015944503180122WJNB8Eid"

modelstring

補完に使用されたモデル

"gpt-5.2"

objectenum<chat.completion>

レスポンスタイプ

"chat.completion"

createdinteger

補完が作成されたUnixタイムスタンプ

1760032810

choicesobject[]

補完選択肢のリスト

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! I'm GPT-5.2, with enhanced reasoning and understanding capabilities. I excel at handling complex problems, multi-step reasoning, and code generation.\\n\\nKey features include:\\n- Stronger logical reasoning\\n- Better context understanding\\n- More accurate code generation"
    },
    "finish_reason": "stop"
  }
]

usageobject

トークン使用統計

{
  "prompt_tokens": 13,
  "completion_tokens": 1891,
  "total_tokens": 1904,
  "prompt_tokens_details": {
    "cached_tokens": 0,
    "text_tokens": 13,
    "audio_tokens": 0,
    "image_tokens": 0
  },
  "completion_tokens_details": {
    "text_tokens": 0,
    "audio_tokens": 0,
    "reasoning_tokens": 1480
  },
  "input_tokens": 0,
  "output_tokens": 0,
  "input_tokens_details": null
}

POST/v1/chat/completions

curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.2",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself"
    }
  ]
}'

レスポンス: 成功

{
  "id": "chatcmpl-20251010015944503180122WJNB8Eid",
  "model": "gpt-5.2",
  "object": "chat.completion",
  "created": 1760032810,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 1891,
    "total_tokens": 1904,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 13,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 1480
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null
  }
}

GPT-5.2 - 完全なAPIリファレンス

OpenAI SDK形式でGPT-5.2モデルを呼び出し

同期処理モード、リアルタイムレスポンス

テキスト会話: シングルターンまたはマルチターンのコンテキスト対話

システムプロンプト: AIのロールと動作をカスタマイズ

マルチモーダル入力: テキスト+画像の混合入力をサポート

クイックスタートはクイックスタートガイドをご確認ください

[ { "index": 0, "message": { "role": "assistant", "content": "Hello! I'm GPT-5.2, with enhanced reasoning and understanding capabilities. I excel at handling complex problems, multi-step reasoning, and code generation.\\n\\nKey features include:\\n- Stronger logical reasoning\\n- Better context understanding\\n- More accurate code generation" }, "finish_reason": "stop" } ]

{ "prompt_tokens": 13, "completion_tokens": 1891, "total_tokens": 1904, "prompt_tokens_details": { "cached_tokens": 0, "text_tokens": 13, "audio_tokens": 0, "image_tokens": 0 }, "completion_tokens_details": { "text_tokens": 0, "audio_tokens": 0, "reasoning_tokens": 1480 }, "input_tokens": 0, "output_tokens": 0, "input_tokens_details": null }

curl --request POST \ --url https://api.starmagic.ai/v1/chat/completions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "gpt-5.2", "messages": [ { "role": "user", "content": "Please introduce yourself" } ] }'

{ "id": "chatcmpl-20251010015944503180122WJNB8Eid", "model": "gpt-5.2", "object": "chat.completion", "created": 1760032810, "choices": [ { "index": 0, "message": { "role": null, "content": null }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 13, "completion_tokens": 1891, "total_tokens": 1904, "prompt_tokens_details": { "cached_tokens": 0, "text_tokens": 13, "audio_tokens": 0, "image_tokens": 0 }, "completion_tokens_details": { "text_tokens": 0, "audio_tokens": 0, "reasoning_tokens": 1480 }, "input_tokens": 0, "output_tokens": 0, "input_tokens_details": null } }