API Documentation

Panduan Aster Gateway

Integrasi publik Aster Gateway dengan format OpenAI-compatible. Gunakan API key Gateway sebagai Bearer token.

Base URLhttps://api.aster-assistant.my.id/v1

AuthBearer API_KEY

Formatapplication/json

01Quick StartEndpoint utama dan header autentikasi.⌄

Chat/chat/completions

Image/images/generations

Image Edit/images/edits

Models/models

Authorization: Bearer $ASTER_API_KEY
Content-Type: application/json

02Chat CompletionsRequest chat OpenAI-compatible, termasuk streaming.⌄

curl https://api.aster-assistant.my.id/v1/chat/completions \
  -H "Authorization: Bearer $ASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role":"user","content":"Halo!"}],
    "stream": true
  }'

03Reasoning EffortGunakan hanya pada model yang mendukung reasoning.⌄

Nilai reasoning_effort harus mengikuti capability model yang digunakan.

{
  "model": "REASONING_MODEL_ID",
  "messages": [{"role":"user","content":"Analisis masalah ini."}],
  "reasoning_effort": "low",
  "stream": true
}

04Vision / Image InputKirim image URL pada model yang mendukung vision.⌄

{
  "model": "VISION_MODEL_ID",
  "messages": [{
    "role": "user",
    "content": [
      {"type":"text","text":"Jelaskan gambar ini."},
      {"type":"image_url","image_url":{"url":"https://example.com/image.jpg"}}
    ]
  }]
}

05Tool CallingAplikasi mengeksekusi tool lalu mengirim hasilnya kembali.⌄

{
  "model": "TOOL_MODEL_ID",
  "messages": [{"role":"user","content":"Cek data terbaru."}],
  "tools": [{
    "type":"function",
    "function":{
      "name":"get_data",
      "parameters":{"type":"object","properties":{"query":{"type":"string"}}}
    }
  }]
}

06Image Generation & EditGenerate gambar baru atau edit reference image.⌄

GeneratePOST /images/generations

EditPOST /images/edits

{
  "model": "IMAGE_MODEL_ID",
  "prompt": "Foto produk minimalis di studio putih.",
  "size": "1024x1024",
  "n": 1
}

Untuk edit, kirim reference image sesuai format endpoint/model yang tersedia.

07Response & ErrorStatus HTTP utama yang perlu ditangani aplikasi.⌄

400Request tidak valid

401API key tidak valid

402Saldo Coin tidak cukup

5xxGateway / upstream gagal

API key bersifat rahasia. Simpan di environment variable atau secret manager. Capability berbeda per model; cek katalog model di portal sebelum memakai Vision, Tools, Reasoning, atau Image.