Responses API — POST /v1/responses

Endpoint /v1/responses triển khai OpenAI Responses API, hỗ trợ các cuộc hội thoại nhiều lượt có trạng thái với tính năng quản lý lịch sử hội thoại tích hợp sẵn. Đây là một lựa chọn thay thế cho /v1/chat/completions dành cho các quy trình yêu cầu định dạng response mới hơn của OpenAI. Truyền previous_response_id để tiếp tục cuộc hội thoại mà không cần gửi lại toàn bộ lịch sử tin nhắn.

Endpoint

POST https://router.flatkey.ai/v1/responses

Khi nào nên sử dụng endpoint này

Sử dụng /v1/responses nếu:

Ứng dụng của bạn được xây dựng trên OpenAI Responses API
Bạn cần quản lý hội thoại có trạng thái
Bạn sử dụng tham số previous_response_id cho các cuộc hội thoại nhiều lượt

Đối với hầu hết các tích hợp mới, /v1/chat/completions là endpoint được khuyến nghị và có hỗ trợ mô hình rộng hơn.

Yêu cầu

Headers

Header	Giá trị
`Authorization`	`Bearer $FLATKEY_API_KEY`
`Content-Type`	`application/json`

Tham số body

string

bắt buộc

ID mô hình cần sử dụng. Chỉ những mô hình hỗ trợ định dạng Responses API mới hợp lệ ở đây.

string | array

bắt buộc

Đầu vào của người dùng cho lượt này. Có thể là một chuỗi hoặc một mảng các đối tượng nội dung.

string

Hướng dẫn cấp hệ thống cho mô hình (tương đương với tin nhắn system trong chat completions).

string

id của một response trước đó. Khi được cung cấp, mô hình tiếp tục cuộc hội thoại từ điểm đó mà không cần client gửi lại lịch sử.

integer

Số lượng token tối đa cần tạo ra.

boolean

Nếu là true, trả về một luồng các sự kiện server-sent. Mặc định: false.

Ví dụ yêu cầu

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="What is the capital of Japan?",
    instructions="Answer concisely.",
)

print(response.output_text)

Hội thoại nhiều lượt với previous_response_id

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

# First turn
response1 = client.responses.create(
    model="gpt-4o",
    input="My name is Alice.",
)

# Second turn — continue from the first
response2 = client.responses.create(
    model="gpt-4o",
    input="What is my name?",
    previous_response_id=response1.id,
)

print(response2.output_text)  # "Your name is Alice."

Phản hồi

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1710000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "The capital of Japan is Tokyo."}
      ]
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 9,
    "total_tokens": 24
  }
}

Các trường phản hồi

string

Định danh duy nhất cho response này. Truyền nó dưới dạng previous_response_id để tiếp tục cuộc hội thoại.

string

Luôn là "response".

integer

Dấu thời gian Unix khi response được tạo ra.

string

Mô hình đã tạo ra response.

array

Mảng các đối tượng đầu ra được tạo ra bởi mô hình.

Hiện thuộc tính của output item

string

Loại đầu ra. "message" cho các response dạng văn bản.

string

Luôn là "assistant" cho đầu ra được tạo ra.

array

Mảng các khối nội dung. Mỗi khối có một type ("output_text") và một chuỗi text.

object

Số lượng token dùng để tính phí.

Hiện thuộc tính của usage

integer

Số lượng token đầu vào đã xử lý.

integer

Số lượng token đầu ra đã tạo ra.

integer

Tổng của token đầu vào và đầu ra.

​Endpoint

​Khi nào nên sử dụng endpoint này

​Yêu cầu

​Headers

​Tham số body

​Ví dụ yêu cầu

​Hội thoại nhiều lượt với previous_response_id

​Phản hồi

​Các trường phản hồi

Endpoint

Khi nào nên sử dụng endpoint này

Yêu cầu

Headers

Tham số body

Ví dụ yêu cầu

Hội thoại nhiều lượt với previous_response_id

Phản hồi

Các trường phản hồi