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.
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.
Authorization: Bearer sk-eth-xxxxxxxxAPI 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 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."}
]
}'# pip install openai
from openai import OpenAI
client = OpenAI(
base_url = "https://etherealmarket.my.id/v1",
api_key = "sk-eth-xxxxxxxx",
)
resp = client.chat.completions.create(
model = "claude-sonnet-5",
messages = [{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)// npm install openai
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://etherealmarket.my.id/v1",
apiKey: "sk-eth-xxxxxxxx",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Halo!" }],
});
console.log(resp.choices[0].message.content);<?php
$payload = [
'model' => 'claude-sonnet-5',
'messages' => [['role' => 'user', 'content' => 'Halo!']],
];
$ch = curl_init('https://etherealmarket.my.id/v1/chat/completions');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer sk-eth-xxxxxxxx',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
]);
$resp = json_decode(curl_exec($ch), true);
echo $resp['choices'][0]['message']['content'];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.
curl https://etherealmarket.my.id/v1/models \
-H "Authorization: Bearer sk-eth-xxxxxxxx"{
"object": "list",
"data": [
{
"id": "claude-sonnet-5",
"object": "model",
"owned_by": "ethereal-market",
"vision": true
}
]
}| Field | Tipe | Keterangan |
|---|---|---|
| id | string | ID model untuk dipakai di field model. |
| owned_by | string | Selalu ethereal-market. |
| vision | boolean | true bila model menerima input gambar. |
| image | boolean | true 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.
| Field | Wajib | Keterangan |
|---|---|---|
| model | ya | ID model dari GET /v1/models. |
| messages | ya | Array pesan {role, content}. Role: system, user, assistant, tool. |
| stream | tidak | true untuk respons SSE bertahap. |
| temperature | tidak | Kreativitas sampel, umumnya 0–2. |
| max_tokens | tidak | Batas panjang jawaban. |
| tools / functions | tidak | Function calling bila model mendukung. |
| stream_options | tidak | include_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.
| Field | Wajib | Keterangan |
|---|---|---|
| model | ya | ID model gambar, mis. gemini-3.1-flash-image. |
| prompt | ya | Deskripsi gambar, maksimal 4000 karakter. |
| n | tidak | Jumlah gambar 1–4 (default 1). Tiap gambar sukses ditagih terpisah. |
| size | tidak | auto, 1024x1024, 1536x1024, 1024x1536, 1792x1024, 1024x1792. |
| response_format | tidak | url (default) atau b64_json. |
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"
}'{
"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 -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."}]
}'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.
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.
{
"error": {
"message": "Model tidak dikenal: foo. Gunakan GET /v1/models untuk daftar model yang tersedia.",
"type": "invalid_request_error",
"code": "model_not_found"
}
}| HTTP | code | Arti |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | Header Authorization tidak ada atau key salah. |
| 400 | invalid_json | Body bukan JSON valid. |
| 400 | model_not_found | ID model tidak terdaftar. Cek GET /v1/models. |
| 400 | not_an_image_model / invalid_n / invalid_size | Model bukan model gambar, atau parameter gambar tidak valid. |
| 402 | insufficient_quota / quota_exceeded | Kuota token key habis. Lakukan top up. |
| 403 | plan_expired | Masa aktif paket unlimited sudah habis. |
| 429 | rate_limit_exceeded / token_rate_limit_exceeded | Melewati batas RPM/TPM. Hormati header Retry-After. |
| 503 | upstream_unconfigured | Provider gateway belum dikonfigurasi di server. |
Rate limit & kuota
- RPM (request per menit) dan TPM (token per menit) diatur per API key oleh admin. Nilai
0berarti tanpa batas. - Saat batas terlampaui, gateway membalas
429beserta headerRetry-After: 60. - Kuota token dipotong per request sesuai biaya model yang dipakai, bukan tarif flat.
- Bila kuota habis, request ditolak
402sebelum 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).
| Paket | Token | Harga | Masa 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 |
Model tersedia
Daftar di bawah diambil langsung dari katalog gateway. Selalu konfirmasi lewat GET /v1/models karena katalog dapat berubah.
| Model ID | Grade | Vision | Provider |
|---|---|---|---|
| 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.