v0.4.0

OpenAPI 3.1.0

Buat pesan Claude

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Buat pesan Claude

Endpoint yang kompatibel dengan API Claude Messages. Setel stream=true untuk menerima peristiwa aliran pesan gaya Claude. Field permintaan, respons, dan error validasi mengikuti protokol Claude Messages; Router juga dapat mengembalikan envelope error gateway yang telah dibersihkan untuk kegagalan infrastruktur.

Header

X-Felo-Channel
Tipe: string

Kode kanal publik yang dipisahkan koma dan berurutan. Hilangkan header ini untuk menggunakan default; default harus digunakan sendiri. Dalam mode wallet, default memindai urutan kanal publik efektif model secara terbalik, melewati kanal yang tidak dipublikasikan atau tidak tersedia, dan memilih penyedia kanal pertama yang tersedia. Ini mencakup endpoint yang tersedia dari penyedia tersebut dengan ID model upstream dan tingkat layanan yang sama. Kanal eksplisit divalidasi dalam urutan yang ditentukan klien; hanya grup penyedia kanal pertama yang dikirimkan. Tidak ada fallback otomatis ke penyedia lain. Header penyedia lama tidak dapat menimpa perutean kanal.

Isi·ClaudeMessagesRequest

wajib

application/json

max_tokens
Tipe: integer
min:
1
wajib

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

Saat ini hanya default (standard) yang didukung. Nilai yang dihilangkan, null, alias, dan string yang tidak didukung akan kembali ke default; tipe lain mengembalikan HTTP 400. Kanal dan harga yang dikonfigurasi tetap tidak berubah. API teks mengirim nilai standar penyedia; API Decisions dan pembuatan menghilangkan field upstream.
stop_sequences
Tipe: array string[]
stream
Tipe: boolean
system
Tipe: string
temperature
Tipe: number
min:
0
maks:
1
thinking
Tipe: object
- propertyName
  Tipe: anything
tool_choice
Tipe: string
tools
Tipe: array object[]
- propertyName
  Tipe: anything
propertyName
Tipe: anything

top_k
Tipe: integer
min:
0

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

Respons

200
Tipe: object · ClaudeMessageResponse

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

Objek penggunaan penyedia. Field-nya bervariasi menurut endpoint dan penyedia.

propertyName
Tipe: anything
propertyName
Tipe: anything
400
Tipe: object · ClaudeErrorResponse

invalid_request_error dari Claude atau error validasi permintaan Router

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
401
Tipe: object · ClaudeErrorResponse

Kunci API Felo tidak valid atau tidak ada

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
402
Tipe: object · ClaudeErrorResponse

Saldo tidak cukup

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
403
Tipe: object · ClaudeErrorResponse

Akun tidak diizinkan menggunakan model. Model yang dinonaktifkan juga ditolak sebelum panggilan upstream. Permintaan dan tugas yang sudah diterima tetap berlanjut.

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
429
Tipe: object · ClaudeErrorResponse

Batas pengeluaran atau permintaan tercapai

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
502
Tipe: object · ClaudeErrorResponse

Permintaan ke penyedia upstream gagal

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: anything
application/json
503
Tipe: object · ClaudeErrorResponse

Penyedia atau layanan tagihan tidak tersedia

Envelope error yang kompatibel dengan API Claude Errors untuk permintaan Messages.
error
Tipe: object
wajib
message
Tipe: string
wajib
type
Tipe: string
wajib
propertyName
Tipe: anything
type
const:
error
wajib
request_id
Tipe: string
propertyName
Tipe: 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
}'

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

Pesan Claude atau respons streaming

Buat pesan Claude

AutentikasiRequired

Buat pesan Claude