Memulai, autentikasi, endpoint, dan kode error
RoboVAI kompatibel dengan client resmi OpenAI dan Anthropic — cukup ganti base_url dan api_key.
https://api.robovai.comEndpoint berikut dikembalikan oleh gateway saat ini; masukkan ke kolom base_url / endpoint API client Anda.
Client kompatibel OpenAI menggunakan https://api.robovai.com/api/open/v1; client kompatibel Anthropic (mis. Claude Code) menggunakan https://api.robovai.com/api/plan.
Buat kunci di “Dasbor → Kunci API”, lalu masukkan ke kolom api_key client Anda.
Setiap permintaan mengirim kunci API melalui HTTP header:
apiDocs.auth.headerFormat kunci: kunci langganan diawali sub_, kunci bayar sesuai pakai diawali api_.
Jangan hardcode kunci di kode frontend atau repo publik; segera setel ulang di dasbor jika bocor.
https://api.robovai.com/api/planKompatibel dengan API Messages Anthropic — untuk Claude Code, SDK resmi Claude, dll. Path lengkap: https://api.robovai.com/api/plan
https://api.robovai.com/api/open/v1Kompatibel dengan API Chat/Completions OpenAI — untuk ChatBox, OpenCat, dll. Path lengkap: https://api.robovai.com/api/open/v1
Endpoint dikelompokkan per modalitas input/output. Chat teks sinkron/stream; pembuatan gambar mengembalikan URL secara sinkron; pembuatan video asinkron (submit lalu polling). Semua body request diteruskan ke provider hulu — hanya model yang wajib; field lain mengikuti spesifikasi model terkait.
Endpoint asinkron: submit untuk mendapatkan task_id, lalu polling hasilnya.
Chat teks sinkron atau streaming, kompatibel dengan protokol OpenAI dan Anthropic.
https://api.robovai.com/api/open/v1/chat/completionsKompatibel OpenAI, mendukung streaming. Path lengkap: https://api.robovai.com/api/open/v1/chat/completions
https://api.robovai.com/api/plan/v1/messagesKompatibel Anthropic, untuk Claude Code dll. Path lengkap: https://api.robovai.com/api/plan/v1/messages
| Status | Arti | Saran |
|---|---|---|
| 400 Bad Request | Parameter permintaan salah | Periksa body, nama model, dan format parameter. |
| 401 Unauthorized | Kunci hilang atau tidak valid | Pastikan header Authorization membawa kunci API yang valid. |
| 402 Payment Required | Saldo tidak cukup atau kuota habis | Top up di dasbor atau ganti kunci. |
| 403 Forbidden | Tidak ada akses ke model | Pastikan paket kunci Anda menyertakan model target. |
| 404 Not Found | Model atau endpoint tidak ditemukan | Verifikasi ID model dan path endpoint. |
| 429 Too Many Requests | Batas laju permintaan | Kurangi frekuensi atau coba lagi nanti. |
https://api.robovai.com/api/open/v1/responsesOpenAI Responses API (termasuk WebSocket). Path lengkap: https://api.robovai.com/api/open/v1/responses
https://api.robovai.com/api/open/v1/embeddingsVektorisasi teks. Path lengkap: https://api.robovai.com/api/open/v1/embeddings
| Field | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| model | string | Ya | ID model. |
| messages | array | Ya | Array pesan dengan role dan content. |
| stream | boolean | Tidak | Streaming respons, default false. |
| temperature | number | Tidak | Temperatur sampling, 0–2, default 1. |
| max_tokens | integer | Tidak | Maksimum token yang dihasilkan. |
| tools |
apiDocs.modalities.text.requestapiDocs.modalities.text.responseMengembalikan URL gambar yang dihasilkan secara sinkron (OpenAI gpt-image via /api/open; Volcengine Doubao Seedream dll. via /api/multimodal; Midjourney via /api/mj).
https://api.robovai.com/api/open/v1/images/generationsOpenAI gpt-image dan model serupa. Path lengkap: https://api.robovai.com/api/open/v1/images/generations
https://api.robovai.com/api/open/v1/images/editsEdit gambar dari gambar referensi. Path lengkap: https://api.robovai.com/api/open/v1/images/edits
https://api.robovai.com/api/multimodal/v1/images/generationsVolcengine Doubao Seedream dan model multimodal serupa. Path lengkap: https://api.robovai.com/api/multimodal/v1/images/generations
Antarmuka asinkron: submit tugas untuk mendapatkan task_id, lalu polling hingga berhasil dan mengembalikan result_url.
https://api.robovai.com/api/multimodal/v1/videos/generationsSubmit pembuatan video, mengembalikan task_id. Path lengkap: https://api.robovai.com/api/multimodal/v1/videos/generations
https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_idQuery status tugas; mengembalikan result_url saat sukses. Path lengkap: https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_id
| Field | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| model | string | Ya |
Alur: POST submit → dapat task_id → polling GET berkala → baca result_url saat status succeeded.
apiDocs.modalities.video.pollResponseEndpoint audio kompatibel OpenAI: teks-ke-suara, transkripsi, terjemahan.
https://api.robovai.com/api/open/v1/audio/speechTTS; menerima teks, mengembalikan audio. Path lengkap: https://api.robovai.com/api/open/v1/audio/speech
https://api.robovai.com/api/open/v1/audio/transcriptionsAudio ke teks. Path lengkap: https://api.robovai.com/api/open/v1/audio/transcriptions
https://api.robovai.com/api/open/v1/audio/translationsTerjemahkan audio ke teks dalam bahasa target. Path lengkap: https://api.robovai.com/api/open/v1/audio/translations
| 500 Internal Server Error |
| Kesalahan server |
| Coba lagi nanti; hubungi dukungan jika berlanjut. |
| 503 Service Unavailable | Layanan sementara tidak tersedia | Boleh coba lagi untuk error sesaat; jangan coba ulang membabi buta endpoint non-idempotent. |
| array |
| Tidak |
| Daftar tool/fungsi yang dapat dipanggil. |
https://api.robovai.com/api/mj/submit/:actionimagine/blend/action/describe dll.; query via GET /api/mj/task/:task_id. Path lengkap: https://api.robovai.com/api/mj/submit/:action
| Field | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| model | string | Ya | ID model (mis. gpt-image, seri Seedream). |
| prompt | string | Ya | Prompt deskripsi gambar. |
| n | integer | Tidak | Jumlah gambar, default 1. |
| size | string | Tidak | Ukuran gambar, mis. 1024x1024. |
| quality | string | Tidak | Kualitas (OpenAI): standard/hd. |
| response_format |
apiDocs.modalities.image.requestapiDocs.modalities.image.response| ID model (mis. seri Seedance). |
| prompt | string | Ya | Prompt deskripsi video. |
| duration | number | Tidak | Durasi video dalam detik, mis. 5. |
| resolution | string | Tidak | Resolusi, mis. 720p, 1080p. |
| ratio | string | Tidak | Rasio aspek, mis. 16:9, 9:16. |
| fps | number | Tidak | Frame per detik, mis. 24, 30. |
apiDocs.modalities.video.requestapiDocs.modalities.video.submitResponse| Field | Tipe | Wajib | Deskripsi |
|---|
| model | string | Ya | ID model (mis. tts-1). |
| input | string | Ya | Teks yang akan disintesis. |
| voice | string | Ya | Suara, mis. alloy, echo, nova. |
| response_format | string | Tidak | Format audio: mp3/opus/aac/flac, default mp3. |
| speed | number | Tidak | Kecepatan, 0.25–4, default 1. |
apiDocs.modalities.audio.request(stream audio biner, Content-Type: audio/mpeg)| string |
| Tidak |
| Format hasil: url atau b64_json, default url. |
| style | string | Tidak | Gaya (OpenAI): vivid/natural. |