개요 | SeedRouter Docs

SeedRouter는 이미지, 동영상, 오디오, 텍스트 모델을 하나의 API와 하나의 API 키로 제공합니다. 이미지, 동영상, 오디오 모델은 비동기 작업으로 실행됩니다. 요청을 제출하면 작업 ID를 받고, 그 ID를 폴링해 결과를 가져옵니다. 텍스트 모델은 해당 모델 공급사의 요청 형식 그대로 답변을 바로 반환합니다.

기본 URL

https://api.seedrouter.ai

HTTPS를 사용하고 요청 본문은 JSON으로 보내세요. 오디오 엔드포인트는 대신 multipart/form-data로 파일을 업로드합니다.

인증

작업 조회를 포함한 모든 요청에서 키를 Bearer 토큰으로 보내세요.

Authorization: Bearer YOUR_API_KEY

Anthropic Messages 엔드포인트는 anthropic-version 헤더와 함께 x-api-key에 키를 넣는 방식도 지원합니다. 자세한 내용은 인증을 참고하세요.

미디어 작업 엔드포인트

메서드	경로	용도
POST	`/v1/images/generations`	이미지 생성 또는 편집 작업을 제출합니다: GPT Image, Nano Banana, Midjourney.
POST	`/v1/videos/generations`	동영상 작업을 제출합니다: Seedance 2.5, 2.0 (ModelArk 요청 본문), Veo 3.1, Kling 3.0, MiniMax H3, SD Video.
POST	`/v1/audio/transcriptions`	오디오 파일을 제출해 Whisper-1로 전사합니다.
POST	`/v1/audio/translations`	오디오 파일을 제출해 Whisper-1로 영어 번역합니다.
GET	`/v1/tasks/{id}`	이미지, 동영상 또는 오디오 작업의 상태와 결과를 조회합니다.

참조 이미지, 동영상, 오디오는 요청 본문에 URL로 전달합니다. 이미지 요청에 입력 이미지가 포함되면 편집 작업이 됩니다. 지원되는 파라미터는 각 모델의 레퍼런스에 나와 있습니다.

텍스트 엔드포인트

메서드	경로	요청 형식
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(스트리밍)
GET	`/v1/models`	사용 가능한 모델 목록을 조회합니다

모든 텍스트 모델이 모든 형식을 지원하지는 않습니다. 지원 형식은 모델의 API 레퍼런스에 적혀 있습니다. 예를 들어 Claude Opus 5.5는 Chat Completions, Responses, Messages를 지원하고, Gemini 텍스트 모델은 /v1beta 경로를 사용합니다.

요청 수명 주기

미디어 작업

요청을 제출합니다. 응답은 완성된 파일이 아니라 작업이므로 id를 저장하세요.
작업이 최종 상태가 될 때까지 폴링합니다. /v1/tasks/{id}의 작업은 processing을 거쳐 completed 또는 failed가 됩니다.
결과를 읽습니다. 이미지는 output.data[].url, 동영상은 output.video_url, Whisper 출력은 output.url에 있습니다. 모든 결과 링크는 SeedRouter 스토리지를 가리킵니다.

실패한 경우 error.code와 error.message를 확인하세요. 실패한 작업은 과금되지 않습니다. 완료 알림 webhook은 없으므로 Webhooks의 설명대로 작업을 폴링하세요.

텍스트 요청

텍스트 요청은 모델의 답변을 같은 응답으로, 공급사 공식 응답 형식 그대로 반환합니다. stream을 true로 설정하거나 Gemini에서는 :streamGenerateContent를 사용하면 서버 전송 이벤트(SSE)로 받을 수 있습니다. 텍스트 모델은 토큰 단위로 과금됩니다.

개요