OpenAI Responses

Sử dụng OpenAI Responses cho các ứng dụng và công cụ lập trình được xây dựng theo định dạng mục phản hồi của OpenAI.

POST https://getrouter.ai/v1/responses

Yêu cầu cơ bản

curl https://getrouter.ai/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "instructions": "Answer in one short paragraph.",
    "input": "Explain what a reverse proxy does."
  }'

Phản hồi bao gồm mảng output chứa các mục phản hồi. SDK có thể cung cấp thuộc tính tiện ích output_text cho phần văn bản đã được tổng hợp.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.responses.create(
    model="MODEL_ID",
    instructions="Answer in one short paragraph.",
    input="Explain what a reverse proxy does.",
)

print(response.output_text)

Node.js / TypeScript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.responses.create({
  model: 'MODEL_ID',
  instructions: 'Answer in one short paragraph.',
  input: 'Explain what a reverse proxy does.',
})

console.log(response.output_text)

Các trường yêu cầu thường dùng

TrườngMô tả
modelModel ID bắt buộc
inputChuỗi hoặc mảng các mục đầu vào
instructionsChỉ dẫn cấp cao cho phản hồi
streamStreaming các sự kiện phản hồi khi là true
max_output_tokensGiới hạn số token đầu ra tối đa
toolsĐịnh nghĩa công cụ cho các model tương thích
tool_choiceHành vi chọn công cụ
reasoningCấu hình suy luận cho các model tương thích
previous_response_idTiếp tục từ một phản hồi trước đó
truncationauto hoặc disabled

Tiếp tục phản hồi

Với các quy trình hỗ trợ tiếp tục phản hồi, hãy truyền ID của phản hồi trước:

{
  "model": "MODEL_ID",
  "previous_response_id": "RESPONSE_ID",
  "input": "Now give me a concrete example."
}

Khả năng hỗ trợ tiếp tục có trạng thái có thể phụ thuộc vào model được chọn và dịch vụ thượng nguồn.

Thu gọn ngữ cảnh

GetRouter cung cấp endpoint thu gọn của OpenAI Responses:

POST https://getrouter.ai/v1/responses/compact

Endpoint này chấp nhận model cùng với input, instructions hoặc previous_response_id. Chỉ sử dụng khi client của bạn triển khai quy trình thu gọn của OpenAI Responses.

curl https://getrouter.ai/v1/responses/compact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "CONVERSATION_INPUT"
  }'

Streaming

Đặt stream thành true để nhận các sự kiện OpenAI Responses. Các sự kiện này không giống các chunk của OpenAI Chat Completions. Xem Streaming.

Lưu ý về tính tương thích

  • Sử dụng model hỗ trợ endpoint OpenAI Responses.
  • Không mặc định rằng model hoạt động với OpenAI Chat Completions cũng hỗ trợ OpenAI Responses.
  • Các công cụ như Codex có thể phụ thuộc vào định dạng sự kiện và công cụ riêng của OpenAI Responses, vì vậy hãy cấu hình theo hướng dẫn tích hợp chuyên biệt.

Bước tiếp theo