시작하기, 인증, 엔드포인트, 오류 코드
RoboVAI는 OpenAI 및 Anthropic 공식 클라이언트와 호환됩니다. base_url과 api_key만 교체하면 됩니다.
https://api.robovai.com아래 엔드포인트는 현재 게이트웨이에서 반환됩니다. 클라이언트의 base_url / API 엔드포인트 필드에 입력하세요.
OpenAI 호환 클라이언트는 https://api.robovai.com/api/open/v1, Anthropic 호환 클라이언트(Claude Code 등)는 https://api.robovai.com/api/plan를 사용합니다.
「대시보드 → API 키」에서 키를 생성한 뒤 클라이언트의 api_key 필드에 입력하세요.
모든 요청은 HTTP 헤더로 API 키를 전송합니다:
apiDocs.auth.header키 형식: 구독 키는 sub_, 종량제 키는 api_ 로 시작합니다.
키를 프론트엔드 코드나 공개 저장소에 하드코딩하지 마세요. 유출 시 대시보드에서 즉시 재설정하세요.
https://api.robovai.com/api/planAnthropic Messages API 호환 — Claude Code, 공식 Claude SDK 등용. 전체 경로: https://api.robovai.com/api/plan
https://api.robovai.com/api/open/v1OpenAI Chat/Completions API 호환 — ChatBox, OpenCat 등용. 전체 경로: https://api.robovai.com/api/open/v1
입출력 모달리티별로 그룹화된 엔드포인트입니다. 텍스트 채팅은 동기/스트리밍, 이미지 생성은 동기적으로 URL을 반환, 동영상 생성은 비동기(제출 후 폴링)입니다. 모든 요청 본문은 상위 제공자로 전달되며 model만 필수이고 나머지 필드는 해당 모델 사양을 따릅니다.
비동기 엔드포인트: task_id를 받으려면 제출한 뒤 결과를 폴링하세요.
동기 또는 스트리밍 텍스트 채팅, OpenAI와 Anthropic 프로토콜 모두 호환.
https://api.robovai.com/api/open/v1/chat/completionsOpenAI 호환, 스트리밍 지원. 전체 경로: https://api.robovai.com/api/open/v1/chat/completions
https://api.robovai.com/api/plan/v1/messagesAnthropic 호환, Claude Code 등용. 전체 경로: https://api.robovai.com/api/plan/v1/messages
https://api.robovai.com/api/open/v1/responses| 상태 | 의미 | 조치 |
|---|---|---|
| 400 Bad Request | 요청 매개변수 오류 | 본문, 모델명, 매개변수 형식을 확인하세요. |
| 401 Unauthorized | 키가 없거나 유효하지 않음 | Authorization 헤더에 올바른 API 키를 넣으세요. |
| 402 Payment Required | 잔액 부족 또는 한도 소진 | 대시보드에서 충전하거나 키를 교체하세요. |
| 403 Forbidden | 모델 접근 권한 없음 | 키의 요금제에 대상 모델이 포함되어 있는지 확인하세요. |
| 404 Not Found | 모델 또는 엔드포인트 없음 | 모델 ID와 엔드포인트 경로를 확인하세요. |
| 429 Too Many Requests | 요청 제한 | 요청 빈도를 낮추거나 나중에 재시도하세요. |
| 500 Internal Server Error | 서버 오류 |
OpenAI Responses API(WebSocket 포함). 전체 경로: https://api.robovai.com/api/open/v1/responses
https://api.robovai.com/api/open/v1/embeddings텍스트 벡터화. 전체 경로: https://api.robovai.com/api/open/v1/embeddings
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| model | string | 예 | 모델 ID. |
| messages | array | 예 | role과 content를 가진 메시지 배열. |
| stream | boolean | 아니오 | 스트리밍 응답, 기본 false. |
| temperature | number | 아니오 | 샘플링 온도, 0–2, 기본 1. |
| max_tokens | integer | 아니오 | 최대 생성 토큰 수. |
| tools | array |
apiDocs.modalities.text.requestapiDocs.modalities.text.response생성된 이미지 URL을 동기적으로 반환합니다(OpenAI gpt-image는 /api/open, Volcengine Doubao Seedream 등은 /api/multimodal, Midjourney는 /api/mj).
https://api.robovai.com/api/open/v1/images/generationsOpenAI gpt-image 및 유사 모델. 전체 경로: https://api.robovai.com/api/open/v1/images/generations
https://api.robovai.com/api/open/v1/images/edits참조 이미지 기반 이미지 편집. 전체 경로: https://api.robovai.com/api/open/v1/images/edits
https://api.robovai.com/api/multimodal/v1/images/generationsVolcengine Doubao Seedream 및 유사 멀티모달 모델. 전체 경로: https://api.robovai.com/api/multimodal/v1/images/generations
비동기 인터페이스: 작업을 제출해 task_id를 받은 뒤, 성공하여 result_url을 반환할 때까지 폴링합니다.
https://api.robovai.com/api/multimodal/v1/videos/generations동영상 생성 제출, task_id 반환. 전체 경로: https://api.robovai.com/api/multimodal/v1/videos/generations
https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_id작업 상태 조회, 성공 시 result_url 반환. 전체 경로: https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_id
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| model | string | 예 | 모델 ID(예: Seedance 시리즈). |
흐름: POST 제출 → task_id 획득 → 주기적 GET 폴링 → status가 succeeded일 때 result_url 읽기.
apiDocs.modalities.video.pollResponseOpenAI 호환 오디오 엔드포인트: 텍스트-음성, 전사, 번역.
https://api.robovai.com/api/open/v1/audio/speechTTS, 텍스트를 입력받아 오디오 반환. 전체 경로: https://api.robovai.com/api/open/v1/audio/speech
https://api.robovai.com/api/open/v1/audio/transcriptions오디오를 텍스트로. 전체 경로: https://api.robovai.com/api/open/v1/audio/transcriptions
https://api.robovai.com/api/open/v1/audio/translations오디오를 대상 언어 텍스트로 번역. 전체 경로: https://api.robovai.com/api/open/v1/audio/translations
| 필드 |
|---|
| 나중에 재시도하세요. 지속되면 지원에 문의하세요. |
| 503 Service Unavailable | 서비스 일시적 사용 불가 | 일시 오류는 재시도 가능. 비멱등 엔드포인트는 맹목적 재시도 금지. |
| 아니오 |
| 호출 가능한 도구/함수 목록. |
https://api.robovai.com/api/mj/submit/:actionimagine/blend/action/describe 등; 조회는 GET /api/mj/task/:task_id. 전체 경로: https://api.robovai.com/api/mj/submit/:action
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| model | string | 예 | 모델 ID(예: gpt-image, Seedream 시리즈). |
| prompt | string | 예 | 이미지 설명 프롬프트. |
| n | integer | 아니오 | 생성 수, 기본 1. |
| size | string | 아니오 | 이미지 크기, 예: 1024x1024. |
| quality | string | 아니오 | 품질(OpenAI): standard/hd. |
| response_format | string |
apiDocs.modalities.image.requestapiDocs.modalities.image.response| prompt |
| string |
| 예 |
| 동영상 설명 프롬프트. |
| duration | number | 아니오 | 동영상 길이(초), 예: 5. |
| resolution | string | 아니오 | 해상도, 예: 720p, 1080p. |
| ratio | string | 아니오 | 화면비, 예: 16:9, 9:16. |
| fps | number | 아니오 | 프레임 속도, 예: 24, 30. |
apiDocs.modalities.video.requestapiDocs.modalities.video.submitResponse| 타입 |
|---|
| 필수 |
|---|
| 설명 |
|---|
| model | string | 예 | 모델 ID(예: tts-1). |
| input | string | 예 | 합성할 텍스트. |
| voice | string | 예 | 음성, 예: alloy, echo, nova. |
| response_format | string | 아니오 | 오디오 형식: mp3/opus/aac/flac, 기본 mp3. |
| speed | number | 아니오 | 속도, 0.25–4, 기본 1. |
apiDocs.modalities.audio.request(바이너리 오디오 스트림, Content-Type: audio/mpeg)| 아니오 |
| 반환 형식: url 또는 b64_json, 기본 url. |
| style | string | 아니오 | 스타일(OpenAI): vivid/natural. |