Quickstart

Masuk ke Developer Portal dengan akun kakak.ai. Buka API Keys, buat key mode production. Simpan token-nya — hanya ditampilkan sekali.

export KAKAK_API_KEY="kk_live_YOUR_TOKEN_HERE"

Upload rubrik atau kriteria evaluasi sebagai standar penilaian (presigned — lihat detail lengkap di Reference Documents):

curl -X POST https://api.platform.kakak.ai/v1/reference-documents \
  -H "Authorization: Bearer $KAKAK_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Rubrik Penilaian Proposal","filename":"rubrik.pdf","mime_type":"application/pdf"}'
# -> {"id":"ref_Z4n8Wd","status":"processing","upload_url":"https://...","expires_at":"..."}

curl -X PUT "$UPLOAD_URL" -H "Content-Type: application/pdf" --data-binary @rubrik.pdf

curl -X POST https://api.platform.kakak.ai/v1/reference-documents/ref_Z4n8Wd/complete \
  -H "Authorization: Bearer $KAKAK_API_KEY"
# Status → "ready" setelah indexing selesai.

curl -X POST https://api.platform.kakak.ai/v1/workflows \
  -H "Authorization: Bearer $KAKAK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_code": "doc-01",
    "name": "Evaluator Proposal",
    "user_prompt": "Nilai metodologi, kebaruan, dan kelayakan.",
    "reference_document_ids": ["ref_Z4n8Wd"],
    "output_format": "json"
  }'

Upload dokumen input dengan alur presigned yang sama seperti langkah 2, lalu jalankan run dengan input_documents:

curl -X POST https://api.platform.kakak.ai/v1/documents \
  -H "Authorization: Bearer $KAKAK_API_KEY" -H "Content-Type: application/json" \
  -d '{"filename":"proposal-budi.pdf","mime_type":"application/pdf"}'
# -> {"id":"doc_9pQ3mN","upload_url":"https://...","expires_at":"..."}

curl -X PUT "$UPLOAD_URL" -H "Content-Type: application/pdf" --data-binary @proposal-budi.pdf

curl -X POST https://api.platform.kakak.ai/v1/documents/doc_9pQ3mN/complete \
  -H "Authorization: Bearer $KAKAK_API_KEY"

curl -X POST https://api.platform.kakak.ai/v1/workflows/wf_7Gk2Qp/runs \
  -H "Authorization: Bearer $KAKAK_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode":"async","input_documents":["doc_9pQ3mN"]}'

# Response 202: {"id":"run_3HbT9m2K","status":"queued"}

File kecil (<4MB total) juga bisa langsung di-attach inline lewat multipart files[] — lihat Runs untuk detail dan batasnya.

curl https://api.platform.kakak.ai/v1/runs/run_3HbT9m2K \
  -H "Authorization: Bearer $KAKAK_API_KEY"

# Response includes output, usage, credits when status="succeeded"