Dokumentasi

Satu endpoint kompatibel OpenAI & Anthropic — dari request pertama sampai pulih dari error, semuanya ada di halaman ini.

Mulai dalam tiga langkah#

1from openai import OpenAI
2
3client = OpenAI(
4    base_url="https://api.cosmosin.io/v1",
5    api_key="sk-cos...",
6)
7
8resp = client.chat.completions.create(
9    model="deepseek-v4-flash",
10    messages=[{"role": "user", "content": "Halo!"}],
11)
12print(resp.choices[0].message.content)

Autentikasi & API key#

Setiap request wajib membawa key lewat header Authorization: Bearer. Satu akun bisa punya banyak key — buat terpisah per tool atau proyek.

1Authorization: Bearer sk-cos...

Format key

Key berprefix sk-cos diikuti 48 karakter hex. Secret lengkap hanya tampil sekali saat dibuat; setelah itu dashboard hanya menampilkan bentuk tersamar (sk-cos…c56789).

Kelola key

Buat dan cabut key dari dashboard. Key yang dicabut langsung berhenti bekerja. Rotasi berkala: buat key baru, perbarui tool-mu, lalu cabut yang lama. Perlakukan key seperti password — jangan taruh di kode client-side, aplikasi mobile, atau repo publik.

Konfigurasi tool#

Snippet siap tempel untuk tool populer. Variabel lingkungan dibaca otomatis oleh klien yang kompatibel.

1export ANTHROPIC_BASE_URL=https://api.cosmosin.io
2export ANTHROPIC_AUTH_TOKEN=sk-cos...
3
4# lanjutkan seperti biasa
5claude "selesaikan migrasi ini"

1{
2  "openai.baseURL": "https://api.cosmosin.io/v1",
3  "openai.apiKey": "sk-cos..."
4}

1# set key dulu: export COSMOSIN_API_KEY=sk-cos...
2model = "deepseek-v4-flash"
3model_provider = "cosmosin"
4
5[model_providers.cosmosin]
6name = "CosmosIn"
7base_url = "https://api.cosmosin.io/v1"
8env_key = "COSMOSIN_API_KEY"
9wire_api = "responses"

1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "cosmosin": {
5      "npm": "@ai-sdk/openai-compatible",
6      "options": {
7        "baseURL": "https://api.cosmosin.io/v1",
8        "apiKey": "sk-cos..."
9      }
10    }
11  }
12}

1Provider:  OpenAI Compatible
2Base URL:  https://api.cosmosin.io/v1
3API Key:   sk-cos...
4Model:     deepseek-v4-flash

1name: CosmosIn
2version: 1.0.0
3schema: v1
4
5models:
6  - name: CosmosIn
7    provider: openai
8    model: deepseek-v4-flash
9    apiBase: https://api.cosmosin.io/v1
10    apiKey: sk-cos...
11    roles:
12      - chat
13      - edit
14      - apply
15    capabilities:
16      - tool_use

Endpoint#

Semua endpoint memakai key yang sama. Body request dan respons mengikuti format OpenAI atau Anthropic yang kompatibel — contoh untuk /v1/chat/completions:

1{
2  "model": "deepseek-v4-flash",
3  "messages": [
4    { "role": "user", "content": "Halo!" }
5  ]
6}

1{
2  "id": "chatcmpl-...",
3  "object": "chat.completion",
4  "model": "deepseek-v4-flash",
5  "choices": [
6    {
7      "message": { "role": "assistant", "content": "Halo! Ada yang bisa saya bantu?" }
8    }
9  ],
10  "usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
11}

Streaming#

Set stream: true untuk menerima respons bertahap sebagai Server-Sent Events (SSE). Tiap event membawa delta JSON dalam format streaming OpenAI; koneksi memakai content-type text/event-stream dan diakhiri sentinel data: [DONE]. Kebanyakan SDK OpenAI mengekspos streaming secara native — cukup iterasi chunk-nya.

1stream = client.chat.completions.create(
2    model="deepseek-v4-flash",
3    messages=[{"role": "user", "content": "Halo!"}],
4    stream=True,
5)
6
7for chunk in stream:
8    delta = chunk.choices[0].delta.content
9    if delta:
10        print(delta, end="", flush=True)

Model#

Isi field model dengan nama model dari katalog — CosmosIn memakai nama model asli tanpa alias samaran. Daftar lengkap beserta harga per token selalu mutakhir di halaman harga; endpoint /v1/models mengembalikan model yang bisa dipanggil key-mu.

Model reasoning#

Model ber-badge Reasoning di katalog memakai sebagian budget token untuk berpikir sebelum menjawab. Atur kedalamannya per request dengan reasoning_effort — makin tinggi makin dalam, tapi makin banyak token dan makin lambat. Di model non-reasoning parameter ini diabaikan, jadi aman untuk selalu dikirim. Level yang didukung mengikuti tiap model; cek badge Reasoning di katalog. Satu catatan: max_tokens yang terlalu rendah bisa membuat jawaban terlihat kosong karena budget-nya habis untuk berpikir — naikkan max_tokens atau hilangkan batasnya.

1{
2  "model": "deepseek-v4-flash",
3  "messages": [
4    { "role": "user", "content": "Halo!" }
5  ],
6  "reasoning_effort": "high"
7}

Embeddings#

Ubah teks menjadi vektor untuk pencarian semantik, clustering, dan retrieval-augmented generation (RAG). Kompatibel dengan OpenAI Embeddings API: kirim input, terima vektor float. Embeddings tidak streaming — flag stream ditolak.

1from openai import OpenAI
2
3client = OpenAI(base_url="https://api.cosmosin.io/v1", api_key="sk-cos...")
4res = client.embeddings.create(model="text-embedding-3-small", input="Halo!")
5print(res.data[0].embedding[:5])  # [0.012, -0.034, 0.041, ...]

Rerank#

Susun ulang kandidat hasil retrieval agar dokumen paling relevan berada di urutan atas. Rerank memakai cross-encoder yang membaca query dan dokumen bersama-sama — lebih akurat daripada cosine similarity untuk memilih konteks terbaik. Pola umum RAG: embed ±20 kandidat lewat /v1/embeddings, rerank ke top-5, lalu kirim ke chat completions.

• query — teks pencarian (string)
• documents — array kandidat dokumen untuk dinilai
• top_n — opsional; batasi jumlah hasil
• model — nama model rerank

1import requests
2res = requests.post(
3    "https://api.cosmosin.io/v1/rerank",
4    headers={"Authorization": "Bearer sk-cos..."},
5    json={
6        "model": "rerank-v3",
7        "query": "rerank",
8        "documents": docs,  # 10-20 kandidat
9        "top_n": 5,
10    },
11)
12for r in res.json()["results"]:
13    print(r["index"], r["relevance_score"])

Video generation#

Buat klip MP4 pendek dari teks atau gambar dengan satu endpoint. Gateway menangani tugas async di sisi server: POST mengembalikan id dengan status pending (HTTP 202), lalu poll GET /v1/videos/{id} tiap ±5 detik sampai status succeeded — respons berisi URL unduhan. Klip tersimpan sementara; unduh segera.

1curl --request POST \
2  --url https://api.cosmosin.io/v1/videos \
3  --header "Authorization: Bearer sk-cos..." \
4  --header "Content-Type: application/json" \
5  --data '{
6    "model": "video-t2v",
7    "prompt": "Kota mini dari kardus hidup di malam hari",
8    "mode": "t2v",
9    "duration": 5
10  }'

Rate limit & kuota#

Batas mengikuti paketmu. Paket langganan diatur oleh rate request per menit dan token pool; kredit PAYG tidak hangus dan hanya dibatasi saldo. Melebihi batas mengembalikan 429 rate_limited — mundur dan coba lagi setelah window reset. Batas per paket ditampilkan di halaman harga.

Kode error#

Error request pertama hampir selalu 401 atau 402: key salah tempel atau saldo belum terisi. Periksa prefix sk-cos, lalu cek saldo di dashboard.

Bentuk error

Error memakai satu envelope JSON yang stabil. Switch berdasarkan field type, jangan parsing message. request_id membantu melacak kegagalan di log.

1{
2  "error": {
3    "type": "rate_limited",
4    "message": "Rate limit exceeded. Please retry later.",
5    "request_id": "req_..."
6  }
7}

Model combos#

Combos adalah id model virtual milikmu sendiri (bentuk combo/<nama>) yang membungkus 1–5 model di balik satu strategi fallback. Gateway mencoba model di panel satu per satu dalam request yang sama: target 1 gagal (402, 403, 500, timeout) → billing dilepas → target 2, dan seterusnya. Circuit breaker melewati model yang sedang down selama cooldown, jadi model bermasalah tidak menyedot latency. Combos privat per pemilik — key lain yang memanggil combo-mu menerima 404. Kelola dari dashboard.

1curl https://api.cosmosin.io/v1/chat/completions \
2  -H "Authorization: Bearer sk-cos..." \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "combo/free-pack",
6    "messages": [{"role": "user", "content": "Halo!"}]
7  }'

Paket & harga#

Harga dalam Rupiah, transparan per token sesuai katalog — tanpa fee tersembunyi. Dua cara membayar: kredit PAYG (top-up, tidak hangus) dan paket langganan dengan token pool. Daftar model, harga, dan batas paket selalu live di halaman harga.