StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
統合ガイド
Claude - Messages API
StarMagicStarMagic
日本語
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
テキストClaudeClaude

Claude - Messages API

  • テキストおよび/または画像コンテンツを含む入力メッセージの構造化リストを送信すると、モデルが会話の次のメッセージを生成します。
  • Messages APIは単一のクエリまたはステートレスなマルチターン会話に使用できます。
<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<claude-haiku-4-5-20251001 | claude-sonnet-4-5-20250929 | claude-opus-4-1-20250805 | claude-sonnet-4-20250514 | claude-opus-4-5-20251101 | claude-opus-4-6 | claude-opus-4-8 | claude-opus-4-7 | claude-sonnet-4-6>必須

プロンプトを完了するモデル。

"claude-haiku-4-5-20251001"
messagesobject[]必須

入力メッセージ。 当社のモデルは、`user`と`assistant`の交互の会話ターンで動作するように訓練されています。新しい`Message`を作成する際、`messages`パラメータで以前の会話ターンを指定すると、モデルは会話内の次の`Message`を生成します。リクエスト内の連続する`user`または`assistant`ターンは、単一のターンに結合されます。 各入力メッセージは、`role`と`content`を持つオブジェクトである必要があります。単一の`user`ロールメッセージを指定することも、複数の`user`と`assistant`メッセージを含めることもできます。

[
  {
    "content": null,
    "role": "user"
  }
]
max_tokensinteger必須

生成を停止するまでの最大トークン数。 モデルはこの最大値に達する_前に_停止する場合があります。このパラメータは生成するトークンの絶対的な最大数のみを指定します。

0
inference_geostring

推論処理の地理リージョンを指定します。未指定の場合はワークスペースの `default_inference_geo` が使われます。

"string"
containerobject

リクエスト間で再利用するためのコンテナ識別子。

context_managementobject

コンテキスト管理設定。

mcp_serversobject[]

このリクエストで使用されるMCPサーバー

[
  {
    "authorization_token": null,
    "name": "string",
    "tool_configuration": null,
    "type": "string",
    "url": "string"
  }
]
metadataobject
{
  "user_id": null
}
output_configobject
{
  "effort": "low",
  "format": {
    "schema": {},
    "type": "string"
  },
  "task_budget": {
    "remaining": 0,
    "total": 0,
    "type": "string"
  }
}
service_tierenum<auto | standard_only>

このリクエストに優先キャパシティ(利用可能な場合)または標準キャパシティを使用するかを決定します。

"auto"
stop_sequencesstring[]

モデルの生成を停止させるカスタムテキストシーケンス。

[
  "string"
]
streamboolean

server-sent events を使用してレスポンスをインクリメンタルにストリーミングするかどうか。

true
systemobject

システムプロンプト。

temperaturenumber

レスポンスに注入されるランダム性の量。 デフォルトは`1.0`。範囲は`0.0`から`1.0`。

0
thinkingobject

Claudeの拡張思考を有効にするための設定。 `type: "enabled"` では `budget_tokens` が必要で、1,024 以上である必要があり、`max_tokens` の上限に含まれます。`display` で思考内容の表示方法を制御できます。 `type: "adaptive"` では、Claude がリクエストの複雑さに応じて拡張思考をいつ、どれだけ使うかを動的に判断します。こちらでも `display` で思考内容の表示方法を制御できます。 `type: "disabled"` では拡張思考を使いません。

tool_choiceobject

モデルが提供されたツールをどのように使用するか。

toolsobject[]

モデルが使用できるツールの定義。

[
  null
]
top_kinteger

各後続トークンについて上位K個のオプションからのみサンプリングします。

0
top_pnumber

nucleus サンプリングを使用。

0

レスポンス

application/json
成功

レスポンスボディ

idstring必須

一意のオブジェクト識別子。 ID のフォーマットと長さは時間とともに変更される場合があります。

"string"
typestring必須

オブジェクトタイプ。 Messagesの場合、これは常に`"message"`です。

"string"
rolestring必須

生成されたメッセージの会話ロール。 これは常に`"assistant"`になります。

"string"
contentobject[]必須

モデルによって生成されたコンテンツ。 これはコンテンツブロックの配列で、各ブロックにはその形状を決定する`type`があります。

[
  null
]
modelenum<claude-haiku-4-5-20251001 | claude-sonnet-4-5-20250929 | claude-opus-4-1-20250805 | claude-sonnet-4-20250514 | claude-opus-4-5-20251101 | claude-opus-4-6 | claude-opus-4-8 | claude-opus-4-7 | claude-sonnet-4-6>必須

リクエストを処理したモデル。

"claude-haiku-4-5-20251001"
stop_reasonenum<end_turn | max_tokens | stop_sequence | tool_use | pause_turn | refusal | model_context_window_exceeded>必須

停止した理由。

"end_turn"
stop_sequencestring必須

生成されたカスタム停止シーケンス(存在する場合)。

"string"
usageobject必須
{
  "cache_creation": null,
  "cache_creation_input_tokens": null,
  "cache_read_input_tokens": null,
  "input_tokens": 0,
  "output_tokens": 0,
  "server_tool_use": null,
  "service_tier": null
}
context_managementobject

コンテキスト管理レスポンス。

containerobject

このリクエストで使用されたコンテナに関する情報。

POST/v1/messages
curl --request POST \
  --url https://api.starmagic.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}'
レスポンス: 成功
{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}