Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Tạo một phản hồi mô hình

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

Tạo một phản hồi mô hình

​

Endpoint tương thích API OpenAI Responses. Phản hồi không streaming thành công dùng cấu trúc đối tượng Responses; khi stream=true endpoint trả về các sự kiện SSE của Responses. Một đối tượng Responses thất bại có thể dùng status=failed với error={code,message} ngay cả khi bản thân yêu cầu HTTP đã hoàn tất.

Header
  • X-Felo-Channel
    Kiểu: string

    Mã kênh công khai được phân tách bằng dấu phẩy, có thứ tự. Bỏ trống header này để dùng default; default phải được dùng một mình. Ở chế độ ví, default quét thứ tự kênh công khai hiệu dụng của mô hình theo chiều ngược, bỏ qua các kênh chưa xuất bản hoặc không khả dụng, và chọn nhà cung cấp của kênh khả dụng đầu tiên. Nó bao gồm các endpoint khả dụng của nhà cung cấp đó có cùng ID mô hình upstream và cùng hạng dịch vụ. Các kênh chỉ định rõ được kiểm tra theo thứ tự do client chỉ định; chỉ nhóm nhà cung cấp của kênh đầu tiên được gửi đi. Không tự động dự phòng sang nhà cung cấp khác. Header nhà cung cấp kiểu cũ không thể ghi đè định tuyến kênh.

Phần thân·ResponsesRequest
bắt buộc
application/json
  • input
    bắt buộc
    • Kiểu: string
  • model
    Kiểu: string
    bắt buộc
  • include
    Kiểu: array string[]
  • instructions
    Kiểu: string
  • max_output_tokens
    Kiểu: integer
    tối thiểu:  
    1

    Integer numbers.

  • metadata
    Kiểu: object
    • propertyName
      Kiểu: anything
  • previous_response_id
    Kiểu: string
  • reasoning
    Kiểu: object
    • propertyName
      Kiểu: anything
  • service_tier
    Kiểu: string | null

    Hiện chỉ hỗ trợ default (tiêu chuẩn). Giá trị bị bỏ trống, null, các bí danh và chuỗi không được hỗ trợ đều quay về default; các loại khác trả về HTTP 400. Các kênh và giá đã cấu hình không thay đổi. API văn bản gửi giá trị tiêu chuẩn của nhà cung cấp; API Decisions và tạo nội dung bỏ qua trường upstream.

  • store
    Kiểu: boolean
  • stream
    Kiểu: boolean
  • temperature
    Kiểu: number
    tối thiểu:  
    0
  • propertyName
    Kiểu: anything
  • text
    Kiểu: object
    • propertyName
      Kiểu: anything
  • tool_choice
    • Kiểu: string
  • tools
    Kiểu: array object[]
    • propertyName
      Kiểu: anything
  • top_p
    Kiểu: number
    tối thiểu:  
    0
    tối đa:  
    1
  • propertyName
    Kiểu: anything
Phản hồi
  • 200
    Kiểu: object · ResponsesResponse

    Đối tượng phản hồi hoặc các sự kiện phản hồi streaming

    • id
      Kiểu: string
      bắt buộc
    • object
      const:  
      response
      bắt buộc
    • status
      Kiểu: string enum
      bắt buộc
      giá trị
      • completed
      • failed
      • in_progress
      • cancelled
      • queued
      • incomplete
    • error
      Kiểu: object · ResponsesError
      • code
        Kiểu: string
        bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • propertyName
        Kiểu: anything
    • metadata
      Kiểu: object
      • propertyName
        Kiểu: anything
    • model
      Kiểu: string
    • output
      Kiểu: array object[]
      • propertyName
        Kiểu: anything
    • output_text
      Kiểu: string
    • usage
      Kiểu: object · Usage

      Đối tượng mức sử dụng của nhà cung cấp. Các trường thay đổi tùy theo endpoint và nhà cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
  • 400
    Kiểu: object · OpenAIErrorResponse

    Yêu cầu, mô hình hoặc ánh xạ nhà cung cấp không hợp lệ

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 401
    Kiểu: object · OpenAIErrorResponse

    Khóa API Felo không hợp lệ hoặc bị thiếu

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 402
    Kiểu: object · OpenAIErrorResponse

    Số dư không đủ

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 403
    Kiểu: object · OpenAIErrorResponse

    Tài khoản không được phép sử dụng mô hình. Các mô hình đã bị vô hiệu hóa cũng bị từ chối trước khi gọi upstream. Các yêu cầu và tác vụ đã được tiếp nhận vẫn tiếp tục.

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 429
    Kiểu: object · OpenAIErrorResponse

    Đã đạt giới hạn chi tiêu hoặc số yêu cầu

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 502
    Kiểu: object · OpenAIErrorResponse

    Yêu cầu tới nhà cung cấp upstream thất bại

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: anything
    application/json
  • 503
    Kiểu: object · OpenAIErrorResponse

    Nhà cung cấp hoặc dịch vụ thanh toán không khả dụng

    Phong bì lỗi tương thích OpenAI. Router có thể bao gồm code và message mà không có đầy đủ các trường upstream tùy chọn.

    • error
      Kiểu: object
      bắt buộc
      • message
        Kiểu: string
        bắt buộc
      • code
        Kiểu: string | null
      • param
        Kiểu: string | null
      • type
        Kiểu: string

        Loại lỗi tương thích OpenAI khi được cung cấp.

      • propertyName
        Kiểu: anything
    • propertyName
      Kiểu: 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"
}

Đối tượng phản hồi hoặc các sự kiện phản hồi streaming

Create a model response