v0.4.0

OpenAPI 3.1.0

Cipta mesej Claude

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Cipta mesej Claude

Endpoint serasi API Claude Messages. Tetapkan stream=true untuk menerima peristiwa strim mesej gaya Claude. Medan permintaan, respons dan ralat pengesahan mengikut protokol Claude Messages; Router juga boleh memulangkan sampul ralat gerbang yang telah dibersihkan untuk kegagalan infrastruktur.

Pengepala

X-Felo-Channel
Jenis: string

Kod saluran awam yang dipisahkan koma dan tersusun. Tinggalkan pengepala ini untuk menggunakan default; default mesti digunakan secara bersendirian. Dalam mod dompet, default mengimbas susunan saluran awam berkesan model secara terbalik, melangkau saluran yang tidak diterbitkan atau tidak tersedia, dan memilih penyedia saluran pertama yang tersedia. Ia merangkumi endpoint tersedia daripada penyedia itu dengan ID model huluan dan tahap perkhidmatan yang sama. Saluran eksplisit disahkan mengikut susunan yang ditetapkan klien; hanya kumpulan penyedia saluran pertama yang dihantar. Tiada sandaran automatik kepada penyedia lain. Pengepala penyedia legasi tidak boleh mengatasi penghalaan saluran.

Badan·ClaudeMessagesRequest

wajib

application/json

max_tokens
Jenis: integer
min:
1
wajib

Integer numbers.
messages
Jenis: array object[] · ClaudeMessage[] 1…
wajib
- content
  wajib
  Jenis: string
- role
  Jenis: string enum
  wajib
  nilai
  user
  assistant
- propertyName
  Jenis: anything
model
Jenis: string
wajib
metadata
Jenis: object
- propertyName
  Jenis: anything
service_tier
Jenis: string | null

Pada masa ini hanya default (standard) disokong. Nilai yang ditinggalkan, null, alias dan rentetan tidak disokong akan kembali kepada default; jenis lain memulangkan HTTP 400. Saluran dan harga yang dikonfigurasikan kekal tidak berubah. API teks menghantar nilai standard penyedia; API Decisions dan penjanaan meninggalkan medan huluan.
stop_sequences
Jenis: array string[]
stream
Jenis: boolean
system
Jenis: string
temperature
Jenis: number
min:
0
maks:
1
thinking
Jenis: object
- propertyName
  Jenis: anything
tool_choice
Jenis: string
tools
Jenis: array object[]
- propertyName
  Jenis: anything
propertyName
Jenis: anything

top_k
Jenis: integer
min:
0

Integer numbers.
top_p
Jenis: number
min:
0
maks:
1
propertyName
Jenis: anything

Respons

200
Jenis: object · ClaudeMessageResponse

Mesej Claude atau respons penstriman
content
Jenis: array object[] · ClaudeContentBlock[]
wajib
type
Jenis: string enum
wajib
nilai
text
image
document
tool_use
tool_result
thinking
content
Jenis: string | array
id
Jenis: string
input
Jenis: object
propertyName
Jenis: anything
name
Jenis: string
source
Jenis: object
propertyName
Jenis: anything
text
Jenis: string
propertyName
Jenis: anything
id
Jenis: string
wajib
model
Jenis: string
wajib
role
const:
assistant
wajib
stop_reason
Jenis: string | null
wajib
type
const:
message
wajib
stop_sequence
Jenis: string | null
usage
Jenis: object · Usage

Objek penggunaan penyedia. Medan berbeza mengikut endpoint dan penyedia.

propertyName
Jenis: anything
propertyName
Jenis: anything
400
Jenis: object · ClaudeErrorResponse

invalid_request_error Claude atau ralat pengesahan permintaan Router

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
401
Jenis: object · ClaudeErrorResponse

Kunci API Felo tidak sah atau tiada

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
402
Jenis: object · ClaudeErrorResponse

Baki tidak mencukupi

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
403
Jenis: object · ClaudeErrorResponse

Akaun tidak dibenarkan menggunakan model ini. Model yang dilumpuhkan juga ditolak sebelum panggilan huluan. Permintaan dan tugas yang telah diterima terus berjalan.

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
429
Jenis: object · ClaudeErrorResponse

Had perbelanjaan atau permintaan telah dicapai

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
502
Jenis: object · ClaudeErrorResponse

Permintaan kepada penyedia huluan gagal

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json
503
Jenis: object · ClaudeErrorResponse

Penyedia atau perkhidmatan pengebilan tidak tersedia

Sampul ralat serasi API Claude Errors untuk permintaan Messages.
error
Jenis: object
wajib
message
Jenis: string
wajib
type
Jenis: string
wajib
propertyName
Jenis: anything
type
const:
error
wajib
request_id
Jenis: string
propertyName
Jenis: anything
application/json

post/api/v1/messages

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
}'

Tunjukkan Skema

{
  "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"
}

Mesej Claude atau respons penstriman

Cipta mesej Claude

PengesahanRequired

Cipta mesej Claude