Dokumentasi API

API reference

Satu endpoint kompatibel OpenAI untuk 121 model AI. Ganti base_url dan API key pada SDK Anda — kode lain tidak perlu diubah.

https://etherealmarket.my.id/v1
Ambil API key Panduan integrasi

Ringkasan

AI Gateway Ethereal Market adalah layanan perantara (gateway) yang memberi Anda satu API key untuk mengakses banyak model dari beberapa provider. Gateway memakai standar OpenAI, jadi SDK resmi OpenAI, LangChain, LlamaIndex, dan tools apa pun yang mendukung “OpenAI Compatible” langsung bekerja.

Base URL

https://etherealmarket.my.id/v1

Autentikasi

Authorization: Bearer <API_KEY>

  • Format request & respons identik dengan OpenAI Chat Completions.
  • Mendukung streaming, vision, dan function calling selama model mendukungnya.
  • Failover otomatis antar-provider bila satu provider gangguan.
  • Pemakaian dipotong dari kuota token sesuai biaya model yang dipakai.

Autentikasi

Setiap request wajib menyertakan API key pada header Authorization dengan skema Bearer.

http
Authorization: Bearer sk-eth-xxxxxxxx

API key dibuat di dashboard pelanggan (gateway-portal → menu Keys). Setiap key punya kuota, masa aktif, serta batas rate limit sendiri. Jangan bagikan key di kode klien publik.

Mulai cepat

Pilih bahasa Anda. Semua contoh memakai model claude-sonnet-5 — ganti dengan model lain dari daftar model.

curl
curl https://etherealmarket.my.id/v1/chat/completions \
  -H "Authorization: Bearer sk-eth-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Halo! Perkenalkan dirimu singkat."}
    ]
  }'

Respons sukses berbentuk objek choices[0].message.content seperti OpenAI. Untuk mengambil potongan teks secara realtime, lihat Streaming.

GET /v1/models

Mengembalikan daftar model yang tersedia untuk key Anda, lengkap dengan penanda dukungan vision.

request
curl https://etherealmarket.my.id/v1/models \
  -H "Authorization: Bearer sk-eth-xxxxxxxx"
response 200
{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5",
      "object": "model",
      "owned_by": "ethereal-market",
      "vision": true
    }
  ]
}
FieldTipeKeterangan
idstringID model untuk dipakai di field model.
owned_bystringSelalu ethereal-market.
visionbooleantrue bila model menerima input gambar.
imagebooleantrue bila model menghasilkan gambar (dipakai di /v1/images/generations).

POST /v1/chat/completions

Endpoint utama. Body mengikuti spesifikasi OpenAI Chat Completions; gateway meneruskan request ke provider yang menyediakan model tersebut, lalu mengembalikan respons apa adanya.

FieldWajibKeterangan
modelyaID model dari GET /v1/models.
messagesyaArray pesan {role, content}. Role: system, user, assistant, tool.
streamtidaktrue untuk respons SSE bertahap.
temperaturetidakKreativitas sampel, umumnya 0–2.
max_tokenstidakBatas panjang jawaban.
tools / functionstidakFunction calling bila model mendukung.
stream_optionstidakinclude_usage otomatis diaktifkan gateway agar pencatatan token akurat.

Parameter lain yang didukung SDK OpenAI ikut diteruskan ke provider. Bila provider tidak mendukung suatu parameter, provider akan mengembalikan error standar OpenAI yang diteruskan ke Anda.

POST /v1/images/generations

Membuat gambar dari deskripsi teks (prompt). Endpoint kompatibel dengan OpenAI Images API — cukup arahkan SDK OpenAI ke base URL gateway dengan API key yang sama. Hanya model gambar (lihat penanda image: true pada GET /v1/models) yang dapat dipakai di sini.

FieldWajibKeterangan
modelyaID model gambar, mis. gemini-3.1-flash-image.
promptyaDeskripsi gambar, maksimal 4000 karakter.
ntidakJumlah gambar 1–4 (default 1). Tiap gambar sukses ditagih terpisah.
sizetidakauto, 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792.
response_formattidakurl (default) atau b64_json.
curl
curl https://etherealmarket.my.id/v1/images/generations \
  --max-time 300 \
  -H "Authorization: Bearer sk-eth-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "Poster promo kopi gula aren di atas meja kayu, cahaya pagi hangat, teks besar 20% OFF",
    "n": 1,
    "size": "1024x1024"
  }'
response 200
{
  "created": 1793464057,
  "data": [
    { "url": "https://.../xxxxxxxx.jpg" }
  ]
}

Proses dapat memakan 15–45 detik per permintaan (hingga beberapa menit saat server cadangan dipakai) — set timeout klien minimal 300 detik. url yang dikembalikan bersifat publik; simpan salinan sendiri bila perlu. Gambar gagal tidak ditagih; setiap gambar sukses memotong kuota sesuai biaya model gambar.

Streaming

Set stream: true untuk menerima Server-Sent Events (text/event-stream). Setiap baris berisi data: {json} dengan potongan delta, diakhiri data: [DONE].

curl
curl -N https://etherealmarket.my.id/v1/chat/completions \
  -H "Authorization: Bearer sk-eth-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Tulis puisi pendek."}]
  }'
python
stream = client.chat.completions.create(
    model = "claude-sonnet-5",
    messages = [{"role": "user", "content": "Tulis puisi pendek."}],
    stream = True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Vision & tools

Model dengan penanda vision: true menerima input gambar melalui format image_url yang sama seperti OpenAI.

python
resp = client.chat.completions.create(
    model = "claude-sonnet-5",
    messages = [{
        "role": "user",
        "content": [
            {"type": "text", "text": "Apa isi gambar ini?"},
            {"type": "image_url", "image_url": {"url": "https://contoh.com/gambar.jpg"}},
        ],
    }],
)

Function calling memakai field tools / tool_choice standar OpenAI. Ketersediaan bergantung pada model yang dipilih.

Error

Semua error memakai format OpenAI dengan field message, type, dan code.

response 400
{
  "error": {
    "message": "Model tidak dikenal: foo. Gunakan GET /v1/models untuk daftar model yang tersedia.",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}
HTTPcodeArti
401missing_api_key / invalid_api_keyHeader Authorization tidak ada atau key salah.
400invalid_jsonBody bukan JSON valid.
400model_not_foundID model tidak terdaftar. Cek GET /v1/models.
400not_an_image_model / invalid_n / invalid_sizeModel bukan model gambar, atau parameter gambar tidak valid.
402insufficient_quota / quota_exceededKuota token key habis. Lakukan top up.
403plan_expiredMasa aktif paket unlimited sudah habis.
429rate_limit_exceeded / token_rate_limit_exceededMelewati batas RPM/TPM. Hormati header Retry-After.
503upstream_unconfiguredProvider gateway belum dikonfigurasi di server.

Rate limit & kuota

  • RPM (request per menit) dan TPM (token per menit) diatur per API key oleh admin. Nilai 0 berarti tanpa batas.
  • Saat batas terlampaui, gateway membalas 429 beserta header Retry-After: 60.
  • Kuota token dipotong per request sesuai biaya model yang dipakai, bukan tarif flat.
  • Bila kuota habis, request ditolak 402 sebelum diteruskan ke provider.

Biaya

Anda membeli paket token sekali bayar, tanpa langganan bulanan. Setiap request memotong kuota sebesar biaya model (input + output). Masa aktif key mengikuti ketentuan paket (token: 30 hari; unlimited: sesuai periode paket).

PaketTokenHargaMasa aktif
Starter 5M Token AI 5.000.000 Rp1.500 30 hari
Basic 10M Token AI 10.000.000 Rp2.500 30 hari
Standard 20M Token AI 20.000.000 Rp4.500 30 hari
Pro 50M Token AI 50.000.000 Rp9.000 30 hari
Business 100M Token AI 100.000.000 Rp14.000 30 hari
Enterprise 200M Token AI 200.000.000 Rp20.000 30 hari

Lihat semua paket →

Model tersedia

Daftar di bawah diambil langsung dari katalog gateway. Selalu konfirmasi lewat GET /v1/models karena katalog dapat berubah.

121 model
Model IDGradeVisionProvider
auto B — bandelbanget - EtherealAi
claude-opus-5 S bandelbanget - EtherealAi, geraikita
claude-opus-5-5 S bandelbanget - EtherealAi, geraikita
claude-sonnet-5 S bandelbanget - EtherealAi, geraikita
deepseek-v4-flash B — bandelbanget - EtherealAi, geraikita
deepseek-v4-flash-0731 B — bandelbanget - EtherealAi
deepseek-v4-flash-vision-exp B bandelbanget - EtherealAi
deepseek-v4-mod B — bandelbanget - EtherealAi
deepseek-v4-pro B — bandelbanget - EtherealAi, geraikita
deepseek-v4.1-flash B bandelbanget - EtherealAi, geraikita
deepseek-v4.1-flash-1017 B bandelbanget - EtherealAi
deepseek-v4.1-flash-1017-mod B bandelbanget - EtherealAi
deepseek-v4.1-flash-mod B bandelbanget - EtherealAi
gemini-4-argon S bandelbanget - EtherealAi, geraikita
glm-5.2 B — bandelbanget - EtherealAi, geraikita
glm-5.2-mod B — bandelbanget - EtherealAi
glm-5.3 B — bandelbanget - EtherealAi, geraikita
glm-5.3-flash B bandelbanget - EtherealAi
glm-5.3-flash-mod B bandelbanget - EtherealAi
glm-5.3-mod B — bandelbanget - EtherealAi
gpt-5.6-luna A bandelbanget - EtherealAi, geraikita
gpt-5.6-sol S bandelbanget - EtherealAi, geraikita
gpt-5.6-terra S bandelbanget - EtherealAi, geraikita
gpt-6-astra S bandelbanget - EtherealAi, geraikita
gpt-6-luna A bandelbanget - EtherealAi, geraikita
gpt-6-sol S bandelbanget - EtherealAi, geraikita
kimi-k2.7-code B — bandelbanget - EtherealAi
kimi-k2.7-code-highspeed B — bandelbanget - EtherealAi
kimi-k2.8 B bandelbanget - EtherealAi
kimi-k3 A — bandelbanget - EtherealAi, geraikita
mimo-v2.5-pro B bandelbanget - EtherealAi
mimo-v2.6-flash B bandelbanget - EtherealAi
mimo-v2.6-pro B bandelbanget - EtherealAi
gemini-3.1-flash-image B — bandelbanget - EtherealAi, geraikita
gemini-3-pro-image B — bandelbanget - EtherealAi, geraikita
flux-2-pro B — bandelbanget - EtherealAi, geraikita
flux-2-flex B — bandelbanget - EtherealAi, geraikita
claude-opus-4-8 B geraikita
claude-opus-4-6 B geraikita
claude-opus-4-7 B geraikita
claude-sonnet-4-6 B geraikita
claude-fable-5 B geraikita
claude-opus-5-thinking B geraikita
claude-sonnet-5-thinking B geraikita
qwen-max B — geraikita
gemma-3-4b B geraikita
palmyra-vision-7b B geraikita
nemotron-nano-3-30b B — geraikita
magistral-small-2509 B geraikita
ministral-3-14b B geraikita
ministral-3-8b B geraikita
ministral-3-3b B geraikita
deepseek-ai-v3.1 B — geraikita
deepseek-ai-v3.2 B — geraikita
gemma-3-27b B — geraikita
gemma-3-12b B — geraikita
minimaxai-m2.5 B — geraikita
minimaxai-m2.1 B — geraikita
minimaxai-m2 B — geraikita
devstral-2-123b B — geraikita
mistral-large-3 B — geraikita
moonshot-kimi-k2-thinking B — geraikita
moonshot-kimi-k2.5 B — geraikita
nemotron-super-3-120b B — geraikita
gpt-oss-120b B — geraikita
gpt-oss-20b B — geraikita
qwen3-32b B — geraikita
qwen3-coder-480b-a35b B — geraikita
qwen3-coder-30b-a3b B — geraikita
qwen3-next-80b-a3b B — geraikita
qwen3-vl-235b-a22b B geraikita
qwen3-235b-a22b-2507 B — geraikita
qwen3-coder-next B — geraikita
zai-glm-4.7-flash B — geraikita
zai-glm-4.7 B — geraikita
zai-glm-5 B — geraikita
claude-opus-5-token B geraikita
claude-opus-5-5-token B geraikita
claude-fable-5-1 B geraikita
gpt-6-1-sol B geraikita
gemini-4-argon-token B geraikita
glm-5-3-flash B geraikita
qwen-3-8-flash B geraikita
qwen-3-8-max B geraikita
deepseek-v4-1-flash-1017 B geraikita
deepseek-v4.1-flash-uncensored B — geraikita
claude-sonnet-5-5 B geraikita
claude-haiku-5-5 B geraikita
gemini-3.8-flash-token B geraikita
gpt-6-1-sol-token B geraikita
qwen-3-8-flash-uncensored B geraikita
minimax-m3-uncensored B geraikita
claude-opus-5-5-uncensored B geraikita
kimi-k3.1-pro-uncensored B geraikita
deepseek-v4.1-flash-1017-uncensored B — geraikita
deepseek-v4-flash-0731-uncensored B — geraikita
kimi-k3-uncensored B geraikita
claude-sonnet-5-5-token B geraikita
claude-sonnet-5-token B geraikita
claude-opus-4-8-token B geraikita
claude-sonnet-4-6-token B geraikita
claude-opus-4-7-token B geraikita
claude-opus-4-6-token B geraikita
claude-fable-5-token B geraikita
claude-fable-5.1-token B geraikita
claude-haiku-5-5-token B geraikita
gpt-6-astra-token B geraikita
gpt-6-luna-token B geraikita
gpt-6-sol-token B geraikita
gpt-5.6-sol-token B geraikita
gpt-5.6-terra-token B geraikita
gpt-5.6-luna-token B geraikita
deepseek-v4-pro-token B — geraikita
deepseek-v4-pro-0813-token B — geraikita
deepseek-v4.1-flash-token B geraikita
deepseek-v4-1-flash-1017-token B geraikita
deepseek-v4-flash-token B — geraikita
glm-5.3-token B — geraikita
glm-5.3-flash-token B — geraikita
glm-5.2-token B — geraikita
deepseek-v4-flash-0731-token B — geraikita

Butuh panduan perangkat?

Langkah demi langkah untuk Cline, Cursor, Continue, LibreChat, Open WebUI, n8n, dan lainnya.

Buka Integrations