Referensi API

Memulai, autentikasi, endpoint, dan kode error

Panggilan API pertama

Pilih cara penagihan dan periksa saldo atau kuota aktif.
Pilih model teks yang diizinkan dan buat kunci yang sesuai. Jangan menganggap kunci dapat dipakai di semua cara penagihan.
Ganti YOUR_MODEL_ID dalam contoh Bash dan masukkan kunci secara privat saat diminta.
Pastikan respons berhasil lalu cocokkan dengan riwayat penggunaan. Panggilan nyata dapat dikenai biaya.

# Bash: replace YOUR_MODEL_ID with an eligible text model from the catalog.
read -r -s -p 'API key: ' ROBOVAI_API_KEY; printf '\n'
curl --fail-with-body 'https://api.robovai.com/v1/chat/completions' \
  -H "Authorization: Bearer ${ROBOVAI_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Reply with OK"}],"max_tokens":32}'
unset ROBOVAI_API_KEY

Mengatasi kesalahan

401: periksa kunci dan endpoint; 402: saldo atau kuota; 429: kurangi permintaan bersamaan dan ikuti petunjuk percobaan ulang; 503: periksa penyedia atau hubungi dukungan.

Memulai

RoboVAI kompatibel dengan client resmi OpenAI dan Anthropic — cukup ganti base_url dan api_key.

Base URL

https://api.robovai.com

Endpoint berikut dikembalikan oleh gateway saat ini; masukkan ke kolom base_url / endpoint API client Anda.

Client kompatibel OpenAI menggunakan https://api.robovai.com/v1; client kompatibel Anthropic (mis. Claude Code) menggunakan https://api.robovai.com.

Buat kunci di “Dasbor → Kunci API”, lalu masukkan ke kolom api_key client Anda.

Autentikasi

Setiap permintaan mengirim kunci API melalui HTTP header:

Authorization: Bearer <api_key>

Format 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.

Daftar Endpoint

Kompatibel Anthropic

https://api.robovai.com

Kompatibel dengan API Messages Anthropic — untuk Claude Code, SDK resmi Claude, dll. Path lengkap: https://api.robovai.com

Kompatibel OpenAI

Endpoint per modalitas

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

Chat teks sinkron atau streaming, kompatibel dengan protokol OpenAI dan Anthropic.

POSTChat Completions

https://api.robovai.com/v1/chat/completions

Kompatibel OpenAI, mendukung streaming. Path lengkap: https://api.robovai.com/v1/chat/completions

POSTMessages (Anthropic)

https://api.robovai.com/v1/messages

Kompatibel Anthropic, untuk Claude Code dll. Path lengkap: https://api.robovai.com/v1/messages

POSTResponses

Kode Error

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.

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

Contoh request

{
  "model": "<model_id>",
  "messages": [
    { "role": "user", "content": "Halo" }
  ],
  "stream": false
}

Contoh response

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "Hai!" }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 4, "completion_tokens": 3 }
}

Pembuatan gambar

Mengembalikan URL gambar yang dihasilkan secara sinkron (OpenAI gpt-image via /v1; Volcengine Doubao Seedream dll. via /v1/multimodal; Midjourney via /v1/mj).

POSTTeks-ke-gambar (OpenAI)

https://api.robovai.com/v1/images/generations

OpenAI gpt-image dan model serupa. Path lengkap: https://api.robovai.com/v1/images/generations

POSTEdit gambar (OpenAI)

https://api.robovai.com/v1/images/edits

Edit gambar dari gambar referensi. Path lengkap: https://api.robovai.com/v1/images/edits

POSTTeks-ke-gambar (multimodal)

https://api.robovai.com/v1/multimodal/images/generations

Volcengine Doubao Seedream dan model multimodal serupa. Path lengkap: https://api.robovai.com/v1/multimodal/images/generations

Pembuatan video

Antarmuka asinkron: submit tugas untuk mendapatkan task_id, lalu polling hingga berhasil dan mengembalikan result_url.

POSTSubmit tugas pembuatan

https://api.robovai.com/v1/multimodal/videos/generations

Submit pembuatan video, mengembalikan task_id. Path lengkap: https://api.robovai.com/v1/multimodal/videos/generations

GETPolling status tugas

https://api.robovai.com/v1/multimodal/videos/tasks/:task_id

Query status tugas; mengembalikan result_url saat sukses. Path lengkap: https://api.robovai.com/v1/multimodal/videos/tasks/:task_id

GETAmbil Konten Video

https://api.robovai.com/v1/multimodal/videos/tasks/:task_id/content

Proxy konten untuk tugas yang berhasil; mengembalikan file video secara langsung (hanya status=succeeded). Jalur lengkap: https://api.robovai.com/v1/multimodal/videos/tasks/:task_id/content

Audio

Endpoint audio kompatibel OpenAI: teks-ke-suara, transkripsi, terjemahan.

POSTTeks-ke-suara

https://api.robovai.com/v1/audio/speech

TTS; menerima teks, mengembalikan audio. Path lengkap: https://api.robovai.com/v1/audio/speech

POSTTranskripsi

https://api.robovai.com/v1/audio/transcriptions

Audio ke teks. Path lengkap: https://api.robovai.com/v1/audio/transcriptions

POSTTerjemahan

https://api.robovai.com/v1/audio/translations

Terjemahkan audio ke teks dalam bahasa target. Path lengkap: https://api.robovai.com/v1/audio/translations

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

Contoh request

{
  "model": "<model_id>",
  "prompt": "kucing di bulan",
  "size": "1024x1024",
  "n": 1
}

Contoh response

{
  "created": 1700000000,
  "data": [
    { "url": "https://.../image.png" }
  ]
}

Field	Tipe	Wajib	Deskripsi
model	string	Ya	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

Contoh request

{
  "model": "<model_id>",
  "prompt": "matahari terbenam di ombak"
}

Contoh response

{
  "task_id": "task_abc123",
  "status": "pending",
  "upstream_id": "upstream_xyz"
}

Contoh request

{
  "model": "tts-1",
  "input": "Halo",
  "voice": "alloy"
}

Contoh response

(stream audio biner, Content-Type: audio/mpeg)

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.