Claude メッセージを作成
Claude Messages API 互換のエンドポイントです。stream=true を設定すると Claude 形式のメッセージストリームイベントを受信します。リクエスト、レスポンス、検証エラーのフィールドは Claude Messages プロトコルに従います。インフラ障害時には、Router がサニタイズされたゲートウェイエラーのエンベロープを返すこともあります。
- 型: stringX
- Felo - Channel カンマ区切りの公開チャンネルコード(順序どおり)。このヘッダーを省略すると default が使われ、default は単独でのみ使用できます。ウォレットモードでは、default はモデルの有効な公開チャンネル順を逆から走査し、未公開または利用不可のチャンネルをスキップして、最初に利用可能なチャンネルのプロバイダーを選択します。そのプロバイダーから、同じ上流モデル ID とサービスティアを持つ利用可能なエンドポイントを含めます。明示的なチャンネルはクライアントが指定した順序で検証され、最初のチャンネルのプロバイダーグループのみが送信されます。他のプロバイダーへの自動フォールバックはありません。従来のプロバイダーヘッダーでチャンネルルーティングを上書きすることはできません。
- 型: integermax
_tokens 最小値:1必須Integer numbers.
- 型: array object[] · ClaudeMessage[] 1…messages必須
Use a document block for a PDF or an image block for a picture. Set source to {type: 'file', file_id: 'felo_file_...'} for an uploaded Felo attachment, {type: 'url', url: 'https://...'} for an HTTPS URL, or provide type, media_type and data for a base64 source. PDF and image URL support are enabled per model.
- content必須
- 型: string
- role型: string 列挙値必須値
- user
- assistant
- property型: anything
Name
- 型: stringmodel必須
- 型: objectmetadata
- property型: anything
Name
- 型: string | nullservice
_tier 現在は default(standard)のみをサポートしています。省略、null、エイリアス、未対応の文字列は default にフォールバックし、それ以外のタイプは HTTP 400 を返します。設定済みのチャンネルと料金は変わりません。テキスト API はプロバイダーの標準値を使用し、Decisions と生成 API は上流のフィールドを省略します。
- 型: array string[]stop
_sequences - 型: booleanstream
- system
- 型: string
- 型: numbertemperature最小値:0最大値:1
- 型: objectthinking
- property型: anything
Name
- tool
_choice - 型: string
- 型: array object[]tools
- property型: anything
Name
- 型: anythingproperty
Name
- 型: integertop
_k 最小値:0Integer numbers.
- 型: numbertop
_p 最小値:0最大値:1 - 型: anythingproperty
Name
- 型: object · ClaudeMessageResponse200
Claude メッセージ、またはストリーミングレスポンス
- 型: array object[] · ClaudeContentBlock[]content必須
- type型: string 列挙値必須値
- text
- image
- document
- tool
_use - tool
_result - thinking
- content型: string | array
- id型: string
- input型: object
- property型: anything
Name
- name型: string
- source型: object
- property型: anything
Name
- text型: string
- property型: anything
Name
- 型: stringid必須
- 型: stringmodel必須
- role定数:assistant必須
- 型: string | nullstop
_reason 必須 - type定数:message必須
- 型: string | nullstop
_sequence - 型: object · Usageusage
プロバイダーの usage オブジェクト。フィールドはエンドポイントとプロバイダーによって異なります。
- property型: anything
Name
- 型: anythingproperty
Name
- 型: object · ClaudeErrorResponse400
Claude の invalid_request_error、または Router のリクエスト検証エラー
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse401
Felo APIキーが無効または未指定です
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse402
残高不足
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse403
アカウントにこのモデルの使用権限がありません。無効化されたモデルも上流呼び出しの前に拒否されます。既に受け付けたリクエストとタスクは継続します。
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse429
支出上限またはリクエスト上限に達しました
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse502
上流プロバイダーへのリクエストに失敗しました
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json - 型: object · ClaudeErrorResponse503
プロバイダーまたは請求サービスが利用できません
Messages リクエスト向けの、Claude Errors API 互換のエラーエンベロープ。
- 型: objecterror必須
- message型: string必須
- type型: string必須
- property型: anything
Name
- type定数:error必須
- 型: stringrequest
_id - 型: anythingproperty
Name
application/json
curl https://openapi.felo.ai/api/v1/messages \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Write a one-sentence greeting."
}
],
"stream": false
}'
{
"id": "string",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "string",
"id": "string",
"name": "string",
"input": {
"additionalProperty": "anything"
},
"content": "string",
"source": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}
],
"model": "string",
"stop_reason": null,
"stop_sequence": null,
"usage": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}