Messages và Responses¶

Ngoài định dạng OpenAI, RevidAPI nhận thêm hai giao thức nữa trên cùng một API key.

POST /v1/messages — định dạng Anthropic¶

Dành cho SDK anthropic và mọi công cụ viết theo chuẩn Anthropic Messages.

import anthropic

client = anthropic.Anthropic(
    api_key="sk_KEY_CUA_BAN",
    base_url="https://revidapi.com",
)

r = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Trả lời ngắn gọn.",
    messages=[{"role": "user", "content": "Chào bạn"}],
)
print(r.content[0].text)

Khác biệt so với định dạng OpenAI:

system là tham số riêng, không nằm trong messages.
max_tokens là bắt buộc. Thiếu nó thì request bị từ chối — đây là yêu cầu của chính giao thức Anthropic, không phải quy định riêng của chúng tôi.
content có thể là mảng khối (text, image, tool_use, tool_result).

POST /v1/responses — định dạng OpenAI Responses¶

Dành cho Codex CLI, OpenAI Agents SDK và các công cụ mới dùng Responses API.

Request được chuyển thẳng tới nguồn, không dịch qua Chat Completions. Lý do: dịch qua lại làm rụng tool call, và một agent mất khả năng gọi hàm thì không đọc được file, không chạy được lệnh — tức là hỏng hẳn.

curl https://revidapi.com/v1/responses \
  -H "Authorization: Bearer sk_KEY_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Viết hàm Python đảo ngược chuỗi."
  }'

Các tham số được giữ nguyên: tools, tool_choice, reasoning, stream, max_output_tokens, temperature, top_p, parallel_tool_calls.

Chọn giao thức nào¶

Bạn đang dùng	Gọi đường này
SDK OpenAI, LangChain, LlamaIndex, n8n, Dify	`/v1/chat/completions`
SDK Anthropic, Claude Code	`/v1/messages`
Codex CLI, OpenAI Agents SDK	`/v1/responses`

Cả ba tính tiền giống nhau, theo bảng model.