Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Buat chat completion

Server:https://openapi.felo.ai
Pustaka Klien

Buat chat completion

​

API Chat Completions yang kompatibel dengan OpenAI. Setel stream=true untuk menerima Server-Sent Events. Respons dan envelope error mengikuti bentuk yang kompatibel dengan Chat Completions/OpenAI.

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·ChatCompletionRequest
wajib
application/json
  • messages
    Tipe: array object[] · ChatMessage[] 1…
    wajib
    • content
      boleh null
      wajib
      • Tipe: string
    • role
      Tipe: string enum
      wajib
      nilai
      • system
      • developer
      • user
      • assistant
      • tool
    • name
      Tipe: string
    • tool_call_id
      Tipe: string
    • tool_calls
      Tipe: array object[]
      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
  • model
    Tipe: string
    wajib
  • max_completion_tokens
    Tipe: integer
    min:  
    1

    Integer numbers.

  • max_tokens
    Tipe: integer
    min:  
    1

    Integer numbers.

  • n
    Tipe: integer
    min:  
    1

    Integer numbers.

  • response_format
    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
    boleh null
    • Tipe: string
  • stream
    Tipe: boolean
  • temperature
    Tipe: number
    min:  
    0
  • tool_choice
    • Tipe: string
  • tools
    Tipe: array object[]
    • propertyName
      Tipe: anything
  • propertyName
    Tipe: anything
  • top_p
    Tipe: number
    min:  
    0
    maks:  
    1
  • user
    Tipe: string
  • propertyName
    Tipe: anything
Respons
  • 200
    Tipe: object · ChatCompletionResponse

    Chat completion atau respons streaming

    • choices
      Tipe: array object[] · ChatChoice[]
      wajib
      • finish_reason
        Tipe: string | null
      • index
        Tipe: integer

        Integer numbers.

      • logprobs
        Tipe: object | null
        • propertyName
          Tipe: anything
      • message
        Tipe: object · ChatMessage
        • content
          boleh null
          wajib
          • Tipe: string
        • role
          Tipe: string enum
          wajib
          nilai
          • system
          • developer
          • user
          • assistant
          • tool
        • name
          Tipe: string
        • tool_call_id
          Tipe: string
        • tool_calls
          Tipe: array object[]
          • propertyName
            Tipe: anything
        • propertyName
          Tipe: anything
      • propertyName
        Tipe: anything
    • id
      Tipe: string
      wajib
    • object
      Tipe: string
      wajib

      Biasanya chat.completion untuk respons non-streaming.

    • created
      Tipe: integer Format: int64

      Signed 64-bit integers (long type).

    • model
      Tipe: string
    • system_fingerprint
      Tipe: string
    • usage
      Tipe: object · Usage

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

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
  • 400
    Tipe: object · OpenAIErrorResponse

    Permintaan, model, atau pemetaan penyedia tidak valid

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 401
    Tipe: object · OpenAIErrorResponse

    Kunci API Felo tidak valid atau tidak ada

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 402
    Tipe: object · OpenAIErrorResponse

    Saldo tidak cukup

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 403
    Tipe: object · OpenAIErrorResponse

    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 OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 429
    Tipe: object · OpenAIErrorResponse

    Batas pengeluaran atau permintaan tercapai

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 502
    Tipe: object · OpenAIErrorResponse

    Permintaan ke penyedia upstream gagal

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
  • 503
    Tipe: object · OpenAIErrorResponse

    Penyedia atau layanan tagihan tidak tersedia

    Envelope error yang kompatibel dengan OpenAI. Router dapat menyertakan code dan message tanpa semua field upstream opsional.

    • error
      Tipe: object
      wajib
      • message
        Tipe: string
        wajib
      • code
        Tipe: string | null
      • param
        Tipe: string | null
      • type
        Tipe: string

        Tipe error yang kompatibel dengan OpenAI jika disediakan.

      • propertyName
        Tipe: anything
    • propertyName
      Tipe: anything
    application/json
Request Example for 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
}'
{
  "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"
}
Create a chat completion