Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

สร้างการตอบกลับของโมเดล

Felo API Support
MIT
เซิร์ฟเวอร์:https://openapi.felo.ai
ไลบรารีไคลเอนต์
Shell Curl

สร้างการตอบกลับของโมเดล

​

endpoint ที่เข้ากันได้กับ OpenAI Responses API การตอบกลับแบบไม่สตรีมมิ่งที่สำเร็จจะใช้รูปแบบออบเจ็กต์ Responses เมื่อ stream=true endpoint จะคืนอีเวนต์ SSE ของ Responses ออบเจ็กต์ Responses ที่ล้มเหลวอาจใช้ status=failed พร้อม error={code,message} ได้ แม้ตัวคำขอ HTTP จะเสร็จสมบูรณ์แล้ว

เฮดเดอร์
  • X-Felo-Channel
    ประเภท: string

    รหัสช่องทางสาธารณะที่คั่นด้วยเครื่องหมายจุลภาคตามลำดับ หากไม่ส่งเฮดเดอร์นี้จะใช้ default โดยต้องใช้ default เดี่ยว ๆ เท่านั้น ในโหมดกระเป๋าเงิน default จะสแกนลำดับช่องทางสาธารณะที่มีผลของโมเดลจากท้ายไปต้น ข้ามช่องทางที่ยังไม่เผยแพร่หรือไม่พร้อมใช้งาน และเลือกผู้ให้บริการของช่องทางแรกที่พร้อมใช้งาน โดยจะรวม endpoint ที่พร้อมใช้งานของผู้ให้บริการรายนั้นที่มี upstream model ID และระดับบริการเดียวกัน ช่องทางที่ระบุอย่างชัดเจนจะถูกตรวจสอบตามลำดับที่ไคลเอนต์กำหนด และส่งเฉพาะกลุ่มผู้ให้บริการของช่องทางแรกเท่านั้น ไม่มีการสลับไปยังผู้ให้บริการรายอื่นโดยอัตโนมัติ เฮดเดอร์ผู้ให้บริการแบบเดิมไม่สามารถแทนที่การกำหนดเส้นทางตามช่องทางได้

บอดี้·ResponsesRequest
จำเป็น
application/json
  • input
    จำเป็น
    • ประเภท: string
  • model
    ประเภท: string
    จำเป็น
  • include
    ประเภท: array string[]
  • instructions
    ประเภท: string
  • max_output_tokens
    ประเภท: integer
    ต่ำสุด:  
    1

    Integer numbers.

  • metadata
    ประเภท: object
    • propertyName
      ประเภท: anything
  • previous_response_id
    ประเภท: string
  • reasoning
    ประเภท: object
    • propertyName
      ประเภท: anything
  • service_tier
    ประเภท: string | null

    ขณะนี้รองรับเฉพาะ default (standard) เท่านั้น ค่าที่ไม่ระบุ ค่า null ชื่อแทน และสตริงที่ไม่รองรับจะถูกแทนด้วย default ส่วนประเภทอื่นจะคืน HTTP 400 ช่องทางและราคาที่กำหนดค่าไว้ยังคงเดิม API ข้อความจะส่งค่ามาตรฐานของผู้ให้บริการ ส่วน Decisions และ API การสร้างผลงานจะไม่ส่งฟิลด์ต้นทางนี้

  • store
    ประเภท: boolean
  • stream
    ประเภท: boolean
  • temperature
    ประเภท: number
    ต่ำสุด:  
    0
  • propertyName
    ประเภท: anything
  • text
    ประเภท: object
    • propertyName
      ประเภท: anything
  • tool_choice
    • ประเภท: string
  • tools
    ประเภท: array object[]
    • propertyName
      ประเภท: anything
  • top_p
    ประเภท: number
    ต่ำสุด:  
    0
    สูงสุด:  
    1
  • propertyName
    ประเภท: anything
การตอบกลับ
  • 200
    ประเภท: object · ResponsesResponse

    ออบเจ็กต์ Response หรืออีเวนต์การตอบกลับแบบสตรีมมิ่ง

    • id
      ประเภท: string
      จำเป็น
    • object
      const:  
      response
      จำเป็น
    • status
      ประเภท: string enum
      จำเป็น
      ค่า
      • completed
      • failed
      • in_progress
      • cancelled
      • queued
      • incomplete
    • error
      ประเภท: object · ResponsesError
      • code
        ประเภท: string
        จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • propertyName
        ประเภท: anything
    • metadata
      ประเภท: object
      • propertyName
        ประเภท: anything
    • model
      ประเภท: string
    • output
      ประเภท: array object[]
      • propertyName
        ประเภท: anything
    • output_text
      ประเภท: string
    • usage
      ประเภท: object · Usage

      ออบเจ็กต์การใช้งานของผู้ให้บริการ ฟิลด์แตกต่างกันตาม endpoint และผู้ให้บริการ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
  • 400
    ประเภท: object · OpenAIErrorResponse

    คำขอ โมเดล หรือการแมปผู้ให้บริการไม่ถูกต้อง

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 401
    ประเภท: object · OpenAIErrorResponse

    คีย์ API ของ Felo ไม่ถูกต้องหรือไม่มี

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 402
    ประเภท: object · OpenAIErrorResponse

    ยอดคงเหลือไม่เพียงพอ

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 403
    ประเภท: object · OpenAIErrorResponse

    บัญชีไม่ได้รับอนุญาตให้ใช้โมเดลนี้ โมเดลที่ปิดใช้งานจะถูกปฏิเสธก่อนเรียกต้นทางเช่นกัน คำขอและงานที่รับไว้แล้วยังคงดำเนินการต่อ

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 429
    ประเภท: object · OpenAIErrorResponse

    ถึงขีดจำกัดการใช้จ่ายหรือจำนวนคำขอแล้ว

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 502
    ประเภท: object · OpenAIErrorResponse

    คำขอไปยังผู้ให้บริการต้นทางล้มเหลว

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
  • 503
    ประเภท: object · OpenAIErrorResponse

    ผู้ให้บริการหรือบริการเรียกเก็บเงินไม่พร้อมใช้งาน

    ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด

    • error
      ประเภท: object
      จำเป็น
      • message
        ประเภท: string
        จำเป็น
      • code
        ประเภท: string | null
      • param
        ประเภท: string | null
      • type
        ประเภท: string

        ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

      • propertyName
        ประเภท: anything
    • propertyName
      ประเภท: anything
    application/json
Request Example for post/api/v1/responses
curl https://openapi.felo.ai/api/v1/responses \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "gpt-5.5",
  "input": "Explain why the sky is blue in one sentence.",
  "stream": false
}'

{
  "id": "string",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "additionalProperty": "anything"
    }
  ],
  "output_text": "string",
  "error": {
    "code": "string",
    "message": "string",
    "additionalProperty": "anything"
  },
  "usage": {
    "additionalProperty": "anything"
  },
  "model": "string",
  "metadata": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}

ออบเจ็กต์ Response หรืออีเวนต์การตอบกลับแบบสตรีมมิ่ง

Create a model response