Tổng quan

SeedRouter cung cấp các mô hình ảnh, video, âm thanh và văn bản qua một API và một khóa API duy nhất. Các mô hình ảnh, video và âm thanh chạy dưới dạng tác vụ bất đồng bộ: bạn gửi yêu cầu, nhận một ID tác vụ rồi truy vấn để lấy kết quả. Các mô hình văn bản trả lời trực tiếp, theo định dạng yêu cầu của nhà cung cấp mô hình.

URL gốc

https://api.seedrouter.ai

Hãy dùng HTTPS và gửi phần thân yêu cầu dạng JSON. Các endpoint âm thanh thì nhận tệp tải lên dạng multipart/form-data.

Xác thực

Gửi khóa của bạn dưới dạng token Bearer trong mọi yêu cầu, kể cả khi truy vấn tác vụ:

Authorization: Bearer YOUR_API_KEY

Endpoint Anthropic Messages cũng chấp nhận khóa trong x-api-key, kèm header anthropic-version. Xem Xác thực.

Endpoint cho tác vụ đa phương tiện

Phương thức	Đường dẫn	Mục đích
POST	`/v1/images/generations`	Gửi tác vụ tạo hoặc chỉnh sửa ảnh: GPT Image, Nano Banana và Midjourney.
POST	`/v1/videos/generations`	Gửi tác vụ video: Seedance 2.5 và 2.0 (thân yêu cầu của ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 và SD Video.
POST	`/v1/audio/transcriptions`	Gửi tệp âm thanh để chép lời bằng Whisper-1.
POST	`/v1/audio/translations`	Gửi tệp âm thanh để dịch sang tiếng Anh bằng Whisper-1.
GET	`/v1/tasks/{id}`	Đọc trạng thái và kết quả của tác vụ ảnh, video hoặc âm thanh.

Ảnh, video và âm thanh tham chiếu được truyền dưới dạng URL trong phần thân yêu cầu. Một yêu cầu ảnh sẽ thành yêu cầu chỉnh sửa khi có ảnh đầu vào. Tham chiếu của từng mô hình liệt kê các tham số của nó.

Endpoint văn bản

Phương thức	Đường dẫn	Định dạng yêu cầu
POST	`/v1/chat/completions`	OpenAI Chat Completions
POST	`/v1/responses`	OpenAI Responses
POST	`/v1/messages`	Anthropic Messages
POST	`/v1beta/models/{model}:generateContent`	Google Gemini
POST	`/v1beta/models/{model}:streamGenerateContent`	Google Gemini, dạng stream
GET	`/v1/models`	Liệt kê các mô hình hiện có

Không phải mô hình văn bản nào cũng hỗ trợ mọi định dạng. Tham chiếu API của mô hình ghi rõ các định dạng nó chấp nhận; ví dụ Claude Opus 5.5 chấp nhận Chat Completions, Responses và Messages, còn các mô hình văn bản Gemini dùng các đường dẫn /v1beta.

Vòng đời của một yêu cầu

Tác vụ đa phương tiện

Gửi yêu cầu. Phản hồi là một tác vụ, không phải tệp hoàn chỉnh: hãy lưu id của nó.
Truy vấn tác vụ cho đến khi nó đạt trạng thái cuối. Tác vụ trên /v1/tasks/{id} báo processing, sau đó là completed hoặc failed.
Đọc kết quả. Ảnh nằm trong output.data[].url, video trong output.video_url và đầu ra Whisper trong output.url. Mọi liên kết kết quả đều trỏ tới kho lưu trữ của SeedRouter.

Nếu thất bại, hãy kiểm tra error.code và error.message. Tác vụ thất bại không bị tính phí. Hiện không có webhook báo hoàn tất; hãy truy vấn tác vụ như mô tả trong Webhooks.

Yêu cầu văn bản

Một yêu cầu văn bản trả về câu trả lời của mô hình ngay trong cùng phản hồi, theo cấu trúc phản hồi chính thức của nhà cung cấp. Đặt stream thành true, hoặc dùng :streamGenerateContent với Gemini, để nhận server-sent events (SSE). Các mô hình văn bản tính phí theo token.