Dokumentasi API

01Pengenalan

Vicurva API adalah layanan chat berbentuk API. Kamu mengirim pesan lewat request HTTP, Vicurva membalas. Bentuknya sama seperti mengobrol di aplikasi chat biasa, hanya saja jalurnya program — bisa dipakai dari web, bot WhatsApp/Telegram/Discord, aplikasi mobile, atau skrip di komputer sendiri.

Dokumentasi ini hanya mencantumkan kemampuan yang tersedia: stalking profil media sosial tertentu, berita Kompas dan CNBC Indonesia, jadwal sepak bola, deployment website ke Vercel, input multimodal, pembuatan gambar AI, dan unduh video TikTok.

02Cara Akses

Setiap request wajib membawa API key di header:

X-API-Key: kunci-akses-kamu

Dua format lain juga diterima kalau lebih nyaman:

• Authorization: Bearer kunci-akses-kamu
• Menempel ?api_key=kunci-akses-kamu di URL

03Endpoint

Body minimal

Hanya dua field yang wajib: model dan contents.

{
  "model": "vicurva-pro-3.7",
  "contents": [
    { "role": "user", "parts": [{ "text": "Halo, apa kabar?" }] }
  ]
}

Contoh curl lengkap

curl -X POST https://vicurva.vercel.app/api/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kunci-akses-kamu" \
  -d '{
    "model": "vicurva-pro-3.7",
    "contents": [
      { "role": "user", "parts": [{ "text": "Jelaskan apa itu internet" }] }
    ]
  }'

04Model

Ada tiga pilihan model. Untuk mengganti, cukup ubah nilai field model di body.

Cara ganti model

Hanya satu baris yang berubah — sisanya persis sama:

curl -X POST https://vicurva.vercel.app/api/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kunci-akses-kamu" \
  -d '{
    "model": "vicurva-code-1.0",
    "contents": [
      { "role": "user", "parts": [{ "text": "Buatkan fungsi Python untuk cek bilangan prima" }] }
    ]
  }'

05Format Pesan

Field contents berisi daftar pesan, bukan teks mentah. Setiap pesan punya dua bagian: role (siapa yang bicara) dan parts (isi pesannya).

Kenapa parts berupa daftar?

Karena satu pesan bisa memuat lebih dari satu hal sekaligus. Contoh paling sering: kamu kirim teks dan gambar dalam satu pesan. Keduanya masuk ke parts yang sama — bukan dua pesan terpisah.

Percakapan bertingkat

Untuk melanjutkan percakapan, kirim ulang seluruh riwayat. Vicurva memakai riwayat itu sebagai konteks. Balasan model sebelumnya disimpan dengan role: "model".

curl -X POST https://vicurva.vercel.app/api/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kunci-akses-kamu" \
  -d '{
    "model": "vicurva-pro-3.7",
    "contents": [
      { "role": "user",  "parts": [{ "text": "Halo" }] },
      { "role": "model", "parts": [{ "text": "Halo! Ada yang bisa dibantu?" }] },
      { "role": "user",  "parts": [{ "text": "Apa itu internet?" }] }
    ]
  }'

06Lampiran

Kamu bisa menyertakan gambar, video, audio, PDF, atau dokumen apa pun bersama pesan teks. File harus sudah punya URL publik (bisa diakses dari internet), lalu URL-nya dimasukkan lewat field file_url.

Dua langkah singkat

1. Dapatkan URL file. Kalau file masih di komputer, unggah dulu ke POST /api/upload-image.
2. Tempel URL-nya di file_url, digabung bersama teks di parts yang sama.

Contoh lengkap

curl -X POST https://vicurva.vercel.app/api/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kunci-akses-kamu" \
  -d '{
    "model": "vicurva-pro-3.7",
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Tolong jelaskan isi gambar ini" },
          { "file_url": "https://iili.io/abcdefg.jpg" }
        ]
      }
    ]
  }'

Kalau ingin upload dulu

curl -X POST https://vicurva.vercel.app/api/upload-image \
  -H "X-API-Key: kunci-akses-kamu" \
  -F "image=@foto.jpg"

Balasannya berisi url yang siap dipakai di file_url.

07Kemampuan

Vicurva menyediakan kemampuan berikut. Selain daftar ini, tidak ada fitur atau kemampuan lain yang dicantumkan dalam dokumentasi.

08Membaca Respons

{
  "status": "success",
  "code": 200,
  "model": "vicurva-pro-3.7",
  "result": "Internet adalah jaringan komputer global yang ...",
  "sumber": [],
  "media": null,
  "saran": [
    "Apa itu IP address?",
    "Bagaimana cara kerja DNS?",
    "Apa bedanya internet dan WiFi?"
  ],
  "usage": { "input_tokens": 42, "output_tokens": 210, "total_tokens": 252 },
  "latency_ms": 1834.21,
  "date": "Senin, 01 Januari 2026 - 10:00:00 WIB"
}

09Batas & Error

Rate limit

Maksimal 5 request per detik per API key. Lewat dari itu akan kena 429.

Kode error

10Pertanyaan Umum