StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
GPT-5.1 - 完整参数文档
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
テキストGPTGPT-5.1

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

  • OpenAI SDK形式でGPT-5.1シリーズモデルを呼び出し
  • 同期処理モード、リアルタイムレスポンス
  • 利用可能なモデル: gpt-5.1（ベース）、gpt-5.1-chat（会話に最適化）、gpt-5.1-thinking（推論出力付き）
  • テキスト会話: シングルターンまたはマルチターンのコンテキスト対話
  • システムプロンプト: AIのロールと動作をカスタマイズ
  • マルチモーダル入力: テキスト+画像の混合入力をサポート
  • ツール呼び出し: Function Callingをサポート
  • 推論出力: gpt-5.1-thinkingは思考プロセスを示すreasoning_contentフィールドを返却
<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.1 | gpt-5.1-chat | gpt-5.1-thinking>必須

チャット補完用モデル名 - **gpt-5.1**: 汎用タスク向けベースモデル - **gpt-5.1-chat**: 会話タスクに最適化 - **gpt-5.1-thinking**: 思考プロセス出力付きの推論機能を搭載（reasoning_contentを返却）

"gpt-5.1"
messagesobject[]必須

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

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

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

false
max_tokensinteger

レスポンスで生成するトークンの最大数

2000
temperaturenumber

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

1
top_pnumber

Nucleus samplingパラメータ - 累積確率に基づくトークンサンプリングを制御 - 例えば、0.9は累積確率上位90%のトークンからサンプリングすることを意味します

0.9
frequency_penaltynumber

頻度ペナルティ、-2.0から2.0の間の数値 - 正の値はテキスト内での出現頻度に基づいて新しいトークンにペナルティを与えます

0
presence_penaltynumber

存在ペナルティ、-2.0から2.0の間の数値 - 正の値はテキスト内に出現するかどうかに基づいて新しいトークンにペナルティを与えます

0
stopobject

ストップシーケンス、これらのシーケンスが一致すると生成が停止します

toolsobject[]

Function Calling用のツールリスト

[
  {
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "指定された場所の現在の天気を取得",
      "parameters": {}
    }
  }
]

レスポンス

application/json
成功

レスポンスボディ

idstring

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

"chatcmpl-abc123"
modelstring

補完に使用されたモデル

"gpt-5.1"
objectenum<chat.completion>

レスポンスタイプ

"chat.completion"
createdinteger

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

1698999496
choicesobject[]

補完選択肢のリスト

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hi there! How can I help you?",
      "reasoning_content": "Let me think about this step by step..."
    },
    "finish_reason": "stop"
  }
]
usageobject

トークン使用統計

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}
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.1",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself"
    }
  ],
  "temperature": 1
}'
レスポンス: 成功
{
  "id": "chatcmpl-abc123",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null,
        "reasoning_content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}