v0.4.0

OpenAPI 3.1.0

Sohbet tamamlama isteği oluşturun

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

Sohbet tamamlama isteği oluşturun

OpenAI uyumlu Chat Completions API'si. Server-Sent Events almak için stream=true ayarlayın. Yanıt ve hata zarfı Chat Completions/OpenAI uyumlu biçimi izler.

Başlıklar

X-Felo-Channel
Tür: string

Virgülle ayrılmış sıralı genel kanal kodları. Varsayılanı kullanmak için bu başlığı atlayın; default tek başına kullanılmalıdır. Cüzdan modunda default, modelin geçerli genel kanal sırasını tersten tarar, yayımlanmamış veya kullanılamayan kanalları atlar ve ilk kullanılabilir kanalın sağlayıcısını seçer. Aynı üst kaynak model kimliğine ve hizmet katmanına sahip, o sağlayıcıya ait kullanılabilir uç noktaları içerir. Açıkça belirtilen kanallar istemcinin belirttiği sırayla doğrulanır; yalnızca ilk kanalın sağlayıcı grubu gönderilir. Diğer sağlayıcılara otomatik geçiş yapılmaz. Eski sağlayıcı başlıkları kanal yönlendirmesini geçersiz kılamaz.

Gövde·ChatCompletionRequest

gerekli

application/json

messages
Tür: array object[] · ChatMessage[] 1…
gerekli
- content
  null olabilir
  gerekli
  Tür: string
- role
  Tür: string enum
  gerekli
  değerler
  system
  developer
  user
  assistant
  tool
- name
  Tür: string
- tool_call_id
  Tür: string
- tool_calls
  Tür: array object[]
  propertyName
  Tür: anything
- propertyName
  Tür: anything
model
Tür: string
gerekli
max_completion_tokens
Tür: integer
min:
1

Integer numbers.
max_tokens
Tür: integer
min:
1

Integer numbers.
n
Tür: integer
min:
1

Integer numbers.
response_format
Tür: object
- propertyName
  Tür: anything
service_tier
Tür: string | null

Şu anda yalnızca default (standart) desteklenir. Atlanan, null, takma adlar ve desteklenmeyen dizeler default değerine döner; diğer türler HTTP 400 döndürür. Yapılandırılmış kanallar ve fiyatlar değişmez. Metin API'leri sağlayıcının standart değerini gönderir; Decisions ve oluşturma API'leri üst kaynak alanını atlar.
stop
null olabilir
Tür: string
stream
Tür: boolean
temperature
Tür: number
min:
0
tool_choice
Tür: string
tools
Tür: array object[]
- propertyName
  Tür: anything
propertyName
Tür: anything

top_p
Tür: number
min:
0
maks:
1
user
Tür: string
propertyName
Tür: anything

Yanıtlar

200
Tür: object · ChatCompletionResponse

Sohbet tamamlama veya akış yanıtı
choices
Tür: array object[] · ChatChoice[]
gerekli
finish_reason
Tür: string | null
index
Tür: integer

Integer numbers.

logprobs
Tür: object | null
propertyName
Tür: anything
message
Tür: object · ChatMessage
content
null olabilir
gerekli
Tür: string
role
Tür: string enum
gerekli
değerler
system
developer
user
assistant
tool
name
Tür: string
tool_call_id
Tür: string
tool_calls
Tür: array object[]
propertyName
Tür: anything
propertyName
Tür: anything
propertyName
Tür: anything
id
Tür: string
gerekli
object
Tür: string
gerekli

Akışsız yanıtlarda genellikle chat.completion.

created
Tür: integer Biçim: int64

Signed 64-bit integers (long type).

model
Tür: string
system_fingerprint
Tür: string
usage
Tür: object · Usage

Sağlayıcı kullanım nesnesi. Alanlar uç noktaya ve sağlayıcıya göre değişir.

propertyName
Tür: anything
propertyName
Tür: anything
400
Tür: object · OpenAIErrorResponse

Geçersiz istek, model veya sağlayıcı eşlemesi

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
401
Tür: object · OpenAIErrorResponse

Geçersiz veya eksik Felo API anahtarı

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
402
Tür: object · OpenAIErrorResponse

Yetersiz bakiye

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
403
Tür: object · OpenAIErrorResponse

Hesabın modeli kullanma izni yok. Devre dışı modeller de üst kaynak çağrılarından önce reddedilir. Mevcut kabul edilmiş istekler ve görevler devam eder.

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
429
Tür: object · OpenAIErrorResponse

Harcama veya istek sınırına ulaşıldı

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
502
Tür: object · OpenAIErrorResponse

Üst kaynak sağlayıcı isteği başarısız oldu

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json
503
Tür: object · OpenAIErrorResponse

Sağlayıcı veya faturalandırma hizmeti kullanılamıyor

OpenAI uyumlu hata zarfı. Router, tüm isteğe bağlı üst kaynak alanları olmadan code ve message içerebilir.
error
Tür: object
gerekli
message
Tür: string
gerekli
code
Tür: string | null
param
Tür: string | null
type
Tür: string

Sağlandığında OpenAI uyumlu hata türü.

propertyName
Tür: anything
propertyName
Tür: anything
application/json

post/api/v1/chat/completions

curl https://openapi.felo.ai/api/v1/chat/completions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Write a one-sentence greeting."
    }
  ],
  "stream": false
}'

Şemayı göster

{
  "id": "string",
  "object": "string",
  "created": 1,
  "model": "string",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "string",
        "name": "string",
        "tool_call_id": "string",
        "tool_calls": [
          {
            "additionalProperty": "anything"
          }
        ],
        "additionalProperty": "anything"
      },
      "finish_reason": null,
      "logprobs": null,
      "additionalProperty": "anything"
    }
  ],
  "usage": {
    "additionalProperty": "anything"
  },
  "system_fingerprint": "string",
  "additionalProperty": "anything"
}

Sohbet tamamlama veya akış yanıtı

Sohbet tamamlama isteği oluşturun

Kimlik doğrulamaRequired

Sohbet tamamlama isteği oluşturun