Permintaan pertama Anda

Panduan ini menuntun Anda melakukan panggilan API pertama dari nol. Sebelum memulai, pastikan:

1. Anda sudah membuat kunci API dan menyimpan kunci lengkapnya.
2. Anda sudah memiliki Base URL: masuk ke dasbor, buka dialog "Quick start", pilih protokol lalu salin. Contoh di bawah memakai https://<your-base-url> sebagai placeholder — ganti dengan milik Anda sendiri.

Platform ini mendukung tiga protokol native; pilih mana pun yang sesuai — penagihan dan saldo identik di semuanya.

Protokol kompatibel OpenAI (rekomendasi default)

Sepenuhnya kompatibel dengan SDK OpenAI: arahkan base_url ke platform dan kode Anda yang sudah ada tetap berfungsi.

cURL

curl https://<your-base-url>/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://<your-base-url>",
)

completion = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

Node.js (openai SDK)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://<your-base-url>",
})

const completion = await client.chat.completions.create({
  model: "your-model",
  messages: [{ role: "user", content: "Hello" }],
})
console.log(completion.choices[0].message.content)

Protokol Anthropic

Isomorfik dengan Anthropic Messages API: autentikasi dengan x-api-key dan sertakan anthropic-version:

curl https://<your-base-url>/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Protokol Gemini

Isomorfik dengan Google GenAI API: ID model dimasukkan ke dalam path, dan autentikasi memakai x-goog-api-key:

curl "https://<your-base-url>/v1beta/models/your-model:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

Verifikasi hasilnya

Permintaan yang berhasil mengembalikan balasan model (untuk protokol OpenAI, balasan ada di choices[0].message.content). Dari sana Anda dapat:

• Memeriksa penggunaan dan perubahan saldo di halaman "Usage" pada dasbor;
• Mengganti your-model dengan ID model asli dari pasar model (modalitas teks, gambar, audio, video, dan berkas didukung).

Kesalahan umum pada panggilan pertama

Tips produksi: simpan kunci di variabel lingkungan (misalnya OPENAI_API_KEY) alih-alih menuliskannya langsung di kode, dan utamakan SDK resmi daripada panggilan HTTP yang ditulis manual — SDK menangani detail kompatibilitas protokol.