メインコンテンツへスキップ
POST
/
v1
/
messages
メッセージを作成
curl --request POST \
  --url https://api.evolink.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
  }
}

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

Authorization: Bearer YOUR_API_KEY

ボディ

application/json
model
enum<string>
必須

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

利用可能なオプション:
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-sonnet-4-6
:

"claude-sonnet-4-5-20250929"

messages
InputMessage · object[]
必須

入力メッセージ。

当社のモデルは、userassistantの交互の会話ターンで動作するように訓練されています。新しいMessageを作成する際、messagesパラメータで以前の会話ターンを指定すると、モデルは会話内の次のMessageを生成します。リクエスト内の連続するuserまたはassistantターンは、単一のターンに結合されます。

各入力メッセージは、rolecontentを持つオブジェクトである必要があります。単一のuserロールメッセージを指定することも、複数のuserassistantメッセージを含めることもできます。

max_tokens
integer
必須

生成を停止するまでの最大トークン数。

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

必須範囲: x >= 1
:

1024

container

ロードするスキルを含むコンテナパラメータ。

context_management
ContextManagementConfig · object

コンテキスト管理設定。

mcp_servers
RequestMCPServerURLDefinition · object[]

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

Maximum array length: 20
metadata
メタデータ · object

リクエストに関するメタデータを記述するオブジェクト。

service_tier
enum<string>

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

利用可能なオプション:
auto,
standard_only
stop_sequences
string[]

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

stream
boolean

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

system

システムプロンプト。

:

"Today's date is 2024-06-01."

temperature
number

レスポンスに注入されるランダム性の量。

デフォルトは1.0。範囲は0.0から1.0

必須範囲: 0 <= x <= 1
:

1

thinking
有効 · object

Claudeの拡張思考を有効にするための設定。

tool_choice
Auto · object

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

tools
(カスタムツール · object | Bashツール(2024-10-22) · object | Bashツール(2025-01-24) · object | コード実行ツール(2025-05-22) · object | CodeExecutionTool_20250825 · object | コンピュータ使用ツール(2024-01-22) · object | MemoryTool_20250818 · object | コンピュータ使用ツール(2025-01-24) · object | テキストエディタツール (2024-10-22) · object | テキストエディタツール (2025-01-24) · object | テキストエディタツール (2025-04-29) · object | TextEditor_20250728 · object | Web 検索ツール (2025-03-05) · object | WebFetchTool_20250910 · object)[]

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

top_k
integer

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

必須範囲: x >= 0
:

5

top_p
number

nucleus サンプリングを使用。

必須範囲: 0 <= x <= 1
:

0.7

レスポンス

メッセージオブジェクト

id
string
必須

一意のオブジェクト識別子。

ID のフォーマットと長さは時間とともに変更される場合があります。

:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

type
string
必須

オブジェクトタイプ。

Messagesの場合、これは常に"message"です。

Allowed value: "message"
role
string
必須

生成されたメッセージの会話ロール。

これは常に"assistant"になります。

Allowed value: "assistant"
content
(テキスト · object | Thinking · object | 編集された思考 · object | ツール使用 · object | サーバーツール使用 · object | Web 検索ツールの結果 · object | ResponseWebFetchToolResultBlock · object | コード実行ツール結果 · object | ResponseBashCodeExecutionToolResultBlock · object | ResponseTextEditorCodeExecutionToolResultBlock · object | MCPツール使用 · object | MCPツール結果 · object | コンテナアップロード · object)[]
必須

モデルによって生成されたコンテンツ。

これはコンテンツブロックの配列で、各ブロックにはその形状を決定するtypeがあります。

model
enum<string>
必須

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

利用可能なオプション:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-sonnet-4-6
:

"claude-sonnet-4-5-20250929"

stop_reason
enum<string> | null
必須

停止した理由。

利用可能なオプション:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal,
model_context_window_exceeded
stop_sequence
string | null
必須

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

usage
使用量 · object
必須

課金とレート制限の使用状況。

context_management
ResponseContextManagement · object

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

container
コンテナ · object

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