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:

curl -X POST https://api.platform.kakak.ai/v1/reference-documents \
  -H "Authorization: Bearer $KAKAK_API_KEY" \
  -F "name=Rubrik Penilaian Proposal" \
  -F "file=@rubrik.pdf"

# Response: {"id":"ref_Z4n8Wd","status":"processing"}
# 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"
  }'

curl -X POST https://api.platform.kakak.ai/v1/workflows/wf_7Gk2Qp/runs \
  -H "Authorization: Bearer $KAKAK_API_KEY" \
  -F "mode=async" \
  -F "files[]=@proposal-budi.pdf"

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

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

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