Tác tử lập trình trên SeedRouter

Các tác tử lập trình có thể dùng SeedRouter làm nhà cung cấp mô hình. Chúng gửi yêu cầu bằng khóa API SeedRouter của bạn, và mỗi yêu cầu được tính phí theo token, trừ vào số dư SeedRouter thay vì dùng gói đăng ký.

Để tác tử gọi các mô hình ảnh và video của SeedRouter, hãy dùng máy chủ MCP hoặc xem Sử dụng SeedRouter từ tác tử AI.

Claude Code

Chạy các lệnh sau trong terminal mà bạn dùng để khởi động Claude Code:

export ANTHROPIC_BASE_URL=https://api.seedrouter.ai
export ANTHROPIC_API_KEY=YOUR_API_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

claude --model claude-opus-5-5

• URL gốc không có đường dẫn. Claude Code tự thêm /v1/messages.
• Ba biến ANTHROPIC_DEFAULT_*_MODEL ánh xạ các bí danh opus, sonnet và haiku của Claude Code sang ID mô hình SeedRouter; các bí danh này cũng được dùng cho công việc chạy nền. Bạn cũng có thể truyền trực tiếp một ID, chẳng hạn claude --model claude-fable-5-1.
• Khóa thay thế gói Claude của bạn. Trong phiên tương tác, Claude Code yêu cầu bạn xác nhận dùng khóa một lần; từ đó, chi phí yêu cầu được trừ vào số dư SeedRouter. Bỏ thiết lập các biến để quay lại dùng gói đăng ký.

Để giữ thiết lập cho mọi lần khởi động, hãy đặt các biến tương tự trong khối env của ~/.claude/settings.json. Khi đó, tệp này chứa khóa có thể dùng số dư của bạn, vì vậy hãy giữ tệp riêng tư.

Biểu phí hiện tại trên mỗi triệu token nằm trên trang của từng mô hình, chẳng hạn Claude Opus 5.5. Hướng dẫn Claude Code ghi lại toàn bộ cách thiết lập, cách hoạt động của bộ nhớ đệm prompt và kết quả kiểm thử.

Codex CLI

Thêm SeedRouter vào tệp ~/.codex/config.toml ở cấp người dùng, giữ nguyên các thiết lập khác:

model = "gpt-6-sol"
model_provider = "seedrouter"

[model_providers.seedrouter]
name = "SeedRouter"
base_url = "https://api.seedrouter.ai/v1"
env_key = "SEEDROUTER_API_KEY"
wire_api = "responses"

Sau đó export khóa và khởi động Codex:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex

• Dùng tệp ở cấp người dùng. Codex bỏ qua model_provider và model_providers trong tệp .codex/config.toml của dự án.
• Chọn mô hình bằng model, hoặc dùng codex -m gpt-6-astra cho một phiên. GPT-6 Astra phù hợp với các tác vụ khó nhất, GPT-6 Sol phù hợp với lập trình hằng ngày và GPT-6 Luna phù hợp với các bước nhanh, ít tốn kém hơn.
• Các mô hình đã kiểm thử là GPT-6. Codex gửi yêu cầu Responses; mô hình văn bản khác cần chấp nhận định dạng Responses như được liệt kê trong tham chiếu API của mô hình đó, và chưa được kiểm thử trong Codex.

Hướng dẫn GPT-6 cho Codex ghi lại cửa sổ ngữ cảnh, các thiết lập mức độ suy luận và kết quả kiểm thử.

Kiểm tra kết nối

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply OK."}]
  }'

Khóa hoạt động sẽ trả về một thông điệp với câu trả lời ngắn. Với Codex, hãy chạy codex exec "Reply OK." sau khi thiết lập cấu hình ở trên.

Chi phí và giới hạn

• Yêu cầu được tính phí theo token trong mỗi phản hồi. Một phiên lập trình gửi tiền tố prompt dài trong mỗi yêu cầu: chỉ dẫn, định nghĩa công cụ và các tệp dự án. Khi mô hình hỗ trợ bộ nhớ đệm prompt, các yêu cầu sau đọc tiền tố này từ bộ nhớ đệm với biểu phí thấp hơn.
• Mỗi yêu cầu xuất hiện trong lịch sử sử dụng. Nạp thêm tín dụng trên trang Thanh toán.
• HTTP 429 nghĩa là có quá nhiều yêu cầu cùng lúc. Hãy giảm số phiên hoặc tác tử con chạy song song và chờ theo Retry-After nếu header này có mặt.

Khắc phục sự cố