API VibeCode

Kirim "stream": true untuk menerima Server-Sent Events. Tiap bingkai adalah chat.completion.chunk, dan aliran ditutup dengan data: [DONE].

Bingkai usage hanya dikirim bila kamu meminta lewat stream_options: {"include_usage": true}. Tagihanmu tidak bergantung pada itu: kami menghitung dari pemakaian yang dilaporkan model, dan kalau angkanya tidak sampai, caranya ada di bagian Cara tagih.

curl -N https://api.vibecodeagent.my.id/v1/chat/completions \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Tulis haiku tentang senja."}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.vibecodeagent.my.id/v1",
    api_key=os.environ["VIBECODE_API_KEY"],
)

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Tulis haiku tentang senja."}],
    stream=True,
    stream_options={"include_usage": True},
)
for bagian in stream:
    if bagian.choices:
        print(bagian.choices[0].delta.content or "", end="", flush=True)
    if bagian.usage:
        print(f"\n[token: {bagian.usage.prompt_tokens} masuk, {bagian.usage.completion_tokens} keluar]")

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.vibecodeagent.my.id/v1",
  apiKey: process.env.VIBECODE_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Tulis haiku tentang senja." }],
  stream: true,
  stream_options: { include_usage: true },
});
for await (const bagian of stream) {
  const teks = bagian.choices?.[0]?.delta?.content;
  if (teks) process.stdout.write(teks);
  if (bagian.usage) {
    console.log(`\n[token: ${bagian.usage.prompt_tokens} masuk, ${bagian.usage.completion_tokens} keluar]`);
  }
}

Kirim definisi fungsi lewat tools; model membalas dengan tool_calls. Di mode streaming, arguments datang bertahap dengan index yang sama, jadi sambungkan potongannya sebelum mengurai JSON. Tidak semua model mendukung pemanggilan fungsi: coba dulu pada model yang kamu pilih.

curl https://api.vibecodeagent.my.id/v1/chat/completions \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Cuaca di Bandung sekarang?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "cuaca_kota",
        "description": "Ambil cuaca terkini untuk satu kota.",
        "parameters": {
          "type": "object",
          "properties": {"kota": {"type": "string"}},
          "required": ["kota"]
        }
      }
    }]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.vibecodeagent.my.id/v1",
    api_key=os.environ["VIBECODE_API_KEY"],
)

alat = [{
    "type": "function",
    "function": {
        "name": "cuaca_kota",
        "description": "Ambil cuaca terkini untuk satu kota.",
        "parameters": {
            "type": "object",
            "properties": {"kota": {"type": "string"}},
            "required": ["kota"],
        },
    },
}]

jawaban = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Cuaca di Bandung sekarang?"}],
    tools=alat,
)
panggilan = jawaban.choices[0].message.tool_calls
if panggilan:
    print(panggilan[0].function.name, panggilan[0].function.arguments)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.vibecodeagent.my.id/v1",
  apiKey: process.env.VIBECODE_API_KEY,
});

const alat = [{
  type: "function",
  function: {
    name: "cuaca_kota",
    description: "Ambil cuaca terkini untuk satu kota.",
    parameters: {
      type: "object",
      properties: { kota: { type: "string" } },
      required: ["kota"],
    },
  },
}];

const jawaban = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Cuaca di Bandung sekarang?" }],
  tools: alat,
});
const panggilan = jawaban.choices[0].message.tool_calls;
if (panggilan) {
  console.log(panggilan[0].function.name, panggilan[0].function.arguments);
}

Kirim hasil fungsinya kembali sebagai pesan role: "tool" dengan tool_call_id yang sama, seperti di OpenAI.

response_format diteruskan ke model. {"type": "json_object"} hanya berlaku di model yang mendukungnya; model lain bisa mengabaikannya atau menolaknya dengan galat 400 upstream_rejected. Minta JSON juga di prompt, dan periksa hasilnya sebelum dipakai.

{
  "model": "deepseek-v4.1-flash",
  "messages": [{"role": "user", "content": "Beri tiga warna dasar sebagai objek JSON."}],
  "response_format": {"type": "json_object"}
}

Daftar di bawah dibaca langsung dari GET /v1/models, tanpa login. Harga dalam Credit per 1 juta token.

Memuat daftar model…

Angka seperti $0,292 Credit adalah Credit VibeCode, bukan dolar AS.

Harga yang ditagih sama dengan di aplikasi. Harga di daftar sudah memperhitungkan lantai tarif: $0,025 Credit untuk 1 juta token masuk dan $0,05 Credit untuk 1 juta token keluar.

GET /v1/models/{id} mengembalikan satu model; id yang tidak tersedia dijawab 404 model_not_found.

curl https://api.vibecodeagent.my.id/v1/models

Galat berbentuk objek OpenAI, dan pesannya berbahasa Inggris:

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

Setiap jawaban membawa header x-request-id; sertakan saat melapor masalah.

Batas biasanya 20 permintaan per menit per akun (jendela geser 60 detik), dihitung lintas semua kuncimu; angka akunmu tampil di Dashboard, bagian Kunci API. Setiap jawaban chat yang lolos pemeriksaan kunci membawa x-ratelimit-limit-requests, x-ratelimit-remaining-requests, dan x-ratelimit-reset-requests.

Kapasitas model dipakai bersama aplikasi VibeCode. Saat penuh, permintaanmu mengantre sampai sekitar 45 detik; kalau tetap penuh, kamu menerima 429 capacity_exhausted. Ikuti header Retry-After (dalam detik) apa adanya: nilainya bisa hanya 1 detik.

Dengan "stream": true, model harus mulai mengirim jawaban dalam 30 detik. Tanpa stream, seluruh jawaban harus selesai dalam 30 detik; kalau tidak, kamu menerima 502 upstream_error (kami bisa mencoba lagi dulu, jadi total waktu tunggu bisa lebih lama); pakai "stream": true untuk jawaban panjang.

• Tiap sisi (masuk dan keluar) dibulatkan ke atas ke satuan terkecil Credit.
• Sebelum model dijalankan, kami memesan taksiran biaya dari saldomu: token masuk ditaksir dari ukuran permintaan (kira-kira 4 byte per token), ditambah batas keluaran. Selesai, selisihnya dikembalikan.
• Kalau kamu tidak mengisi max_tokens maupun max_completion_tokens, kami memasang batas keluaran sebesar yang bisa dibayar saldomu, paling banyak 32.768 token. Jawaban panjang lalu bisa berakhir dengan finish_reason: "length"; setel max_tokens sendiri untuk jawaban panjang.
• Kalau saldo tidak cukup untuk taksiran itu, permintaan ditolak 402 sebelum model dijalankan.
• Tagihan lewat API tidak pernah membuat saldomu negatif. Kalau biaya sebenarnya melebihi taksiran dan sisa saldo tidak cukup menutupnya, kamu ditagih sebesar saldo yang tersedia; kelebihannya tidak ditagihkan.
• Kalau angka usage dari model tidak sampai (mis. aliran dari model terputus), kami menagih sesuai teks yang sudah terkirim (kira-kira 4 byte per token) dan menandainya "ditaksir" di log.
• Satu kalimat identitas singkat (sekitar 30 token) ditambahkan ke permintaanmu supaya model tahu namanya; ia ikut ditagih sebagai token masuk.
• Log permintaan (tanpa isi pesan) disimpan 30 hari; ringkasan harian tetap tersimpan. Lihat di halaman Credit.
• Kalau server kami dimulai ulang tepat saat permintaanmu berjalan, saldo yang dipesan untuk permintaan itu bisa tertahan. Bila saldomu terasa kurang, hubungi admin VibeCode dan sebutkan x-request-id.

Alat apa pun yang bisa memakai endpoint "OpenAI compatible" bisa dipakai dengan tiga isian: alamat dasar https://api.vibecodeagent.my.id/v1, kunci sk-vc-…, dan id model dari daftar. Nama menu bisa berbeda antar versi alat.

models:
  - name: VibeCode
    provider: openai
    model: deepseek-v4.1-flash
    apiBase: https://api.vibecodeagent.my.id/v1
    apiKey: sk-vc-...

• Jangan taruh kunci di kode frontend yang publik. API ini mengizinkan permintaan dari peramban asal mana pun (CORS terbuka), jadi siapa pun yang membaca sumber halamanmu bisa memakai saldomu.
• Simpan kunci di variabel lingkungan atau penyimpan rahasia, satu kunci per aplikasi.
• Kunci yang bocor: cabut di Dashboard, bagian Kunci API. Pencabutan berlaku langsung, dan permintaan berikutnya dengan kunci itu dijawab 401.
• Kami tidak pernah meminta kuncimu lewat email atau chat.
• Rute dan token akun yang dipakai aplikasi VibeCode dan Chat web hanya untuk keduanya. Akses terprogram ke model lewat satu-satunya jalan ini: kunci sk-vc-…. Rinciannya di Syarat dan Ketentuan.