AI 에이전트에서 SeedRouter 사용

에이전트는 세 가지 방식으로 SeedRouter를 사용할 수 있습니다. 모두 같은 API 키, 잔액, 모델, 제한을 공유하며 과금 방식도 같습니다.

에이전트 자체를 SeedRouter의 텍스트 모델로 실행하려면 SeedRouter에서 코딩 에이전트 사용을 참고하세요.

키를 한 번 설정하세요

API 키 페이지에서 키를 생성하고 환경 변수로 내보내세요. 그러면 프로젝트 파일에 키를 저장하지 않고도 에이전트가 읽을 수 있습니다:

export SEEDROUTER_API_KEY=YOUR_API_KEY

API 키 페이지의 MCP로 연결 버튼에서도 각 MCP 클라이언트에 바로 사용할 수 있는 설정을 표시합니다.

에이전트가 SeedRouter에서 하는 일

1. 모델 찾기: MCP의 list_models 또는 /llms.txt의 모델 목록을 사용합니다. 랜딩 페이지가 있는 각 모델에는 https://seedrouter.ai/models/<slug>/llms.txt에 파라미터, 요금, 예제를 담은 일반 텍스트 요약이 있습니다.
2. 입력 스키마 읽기: MCP의 get_model_schema 또는 모델의 문서 페이지를 사용합니다.
3. 공개 미디어 URL 사용: 생성 엔드포인트는 참조 이미지, 동영상, 오디오를 공개 http(s) URL로만 받습니다. Base64 입력은 거부되므로 로컬 파일을 먼저 접근 가능한 곳에 호스팅하세요.
4. 요금 확인: MCP의 get_pricing은 제출 전에 모델의 현재 요금을 USD로 반환합니다.
5. 제출하고 대기: submit_task를 호출한 다음 작업이 끝날 때까지 wait_seconds: 50으로 get_task를 호출합니다. HTTP에서는 모델의 엔드포인트에 제출한 뒤 약 3초마다 GET /v1/tasks/{id}를 폴링합니다.

실패한 작업은 과금되지 않습니다. 제출은 멱등하지 않습니다. 응답을 받지 못한 요청을 재시도하면 두 번째 작업이 생성되고 그 비용도 차감되므로, 먼저 작업 내역이나 잔액을 확인하세요.

운용 시 고려할 제한

짧은 시간에 요청이 너무 많이 몰려 제한될 수도 있으며, 이때도 HTTP 429가 반환됩니다. HTTP 429를 받으면 Retry-After가 있을 때 해당 시간만큼 기다리세요. 없으면 대기 시간에 무작위 변동과 상한을 두고 재시도할 때마다 지수적으로 늘리세요. 텍스트 엔드포인트는 해당 프로토콜의 오류 형식으로 응답하므로, 오류 본문을 파싱하지 말고 상태 코드로 판단하세요. 배치 작업에서는 큐를 유지하고 실행 중인 작업이 끝날 때 새 작업을 제출하세요. 모든 작업을 한꺼번에 보내지 마세요. 더 높은 한도가 필요하면 [email protected]로 문의하세요.

기계가 읽을 수 있는 진입점