PANDUAN DASAR

Quickstart

Panduan teknis memulai integrasi dengan gateway universal CIORA AI.

Base URL:https://ciora.id/v1

OpenAI: /v1/chat/completions

Anthropic: /v1/messages

Model Default: ciora-ai-free

CIORA memberikan akses terpadu ke puluhan model AI global terbaik melalui satu gateway API berstandar universal (OpenAI dan Anthropic compatible). Gateway menangani routing cerdas, automatic fallback, efisiensi biaya, serta didukung pembayaran instan lokal via QRIS Rupiah (IDR).

Pilihan Pendekatan Integrasi

Pendekatan	Cocok Untuk
Direct REST API	Kontrol penuh, kompatibel dengan semua bahasa pemrograman (cURL, Python requests, TypeScript fetch), tanpa dependensi library eksternal.
OpenAI SDK	Drop-in replacement tercepat untuk projek Python atau Node.js yang sudah ada, cukup ubah baseURL ke https://ciora.id/v1.
Anthropic Messages API	Dukungan native endpoint /v1/messages untuk Claude Code CLI, Cursor, atau Anthropic SDK.
AI Coding Assistant & IDE	Langsung gunakan di Claude Code CLI, Cursor IDE, Windsurf, Aider, atau Open WebUI.

Menggunakan REST API Langsung

Cara paling langsung menggunakan CIORA. Kirimkan HTTP POST request standar ke endpoint /v1/chat/completions. Pendekatan ini dapat dijalankan pada bahasa pemrograman dan framework apa pun tanpa memerlukan SDK tambahan.

Base URL Universal

Endpoint API utama CIORA adalah https://ciora.id/v1. Seluruh rute chat completions berada di https://ciora.id/v1/chat/completions.

curl -X POST https://ciora.id/v1/chat/completions \
  -H "Authorization: Bearer $CIORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ciora-ai-free",
    "messages": [
      {"role": "user", "content": "Halo CIORA, apa makna dari AI Gateway?"}
    ]
  }'

Menggunakan OpenAI SDK

Jika projek kamu sudah menggunakan library resmi OpenAI (openai), kamu dapat menggunakan CIORA sebagai drop-in replacement tanpa perlu mengubah arsitektur kode. Cukup ubah baseURL mengarah ke https://ciora.id/v1.

Dukungan Streaming SSE

Untuk mengaktifkan streaming output token secara real-time, cukup tambahkan parameter stream=True (Python) atau stream: true (TypeScript).

import OpenAI from 'openai'

const openai = new OpenAI({
  baseURL: 'https://ciora.id/v1',
  apiKey: process.env.CIORA_API_KEY,
})

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'ciora-ai-free',
    messages: [
      { role: 'user', content: 'Jelaskan perbedaan synchronous vs asynchronous dalam 2 kalimat.' }
    ],
  })

  console.log(completion.choices[0].message.content)
}

main()

Menggunakan Anthropic Messages API

CIORA mendukung rute native Anthropic di /v1/messages. Fitur ini memungkinkan kamu memakai Anthropic SDK resmi atau tool yang membutuhkan format payload Anthropic Messages secara langsung.

curl -X POST https://ciora.id/v1/messages \
  -H "x-api-key: $CIORA_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "ciora-ai-free",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Sebutkan 3 pilar arsitektur software yang baik."}
    ]
  }'

Integrasi dengan AI Coding Assistant

Kamu dapat menghubungkan CIORA langsung ke IDE coding cerdas seperti Claude Code CLI, Cursor, Windsurf, Aider, atau Open WebUI untuk memanfaatkan performa model mutakhir dengan biaya saldo IDR yang jauh lebih terjangkau.

Konfigurasi Claude Code CLI

Cukup export ANTHROPIC_BASE_URL="https://ciora.id/v1" dan ANTHROPIC_API_KEY="$CIORA_API_KEY" di shell terminal kamu, lalu jalankan claude.

# Set environment variables untuk CIORA gateway
export ANTHROPIC_BASE_URL="https://ciora.id/v1"
export ANTHROPIC_API_KEY="$CIORA_API_KEY"

# Jalankan Claude Code di terminal
claude

Format Response & Token Usage

Gateway CIORA mengembalikan response standar OpenAI lengkap dengan metadata token usage (prompt_tokens, completion_tokens, total_tokens) dan finish reasons:

{
  "id": "chatcmpl-ciora-9df182ac",
  "object": "chat.completion",
  "created": 1757754000,
  "model": "ciora-ai-free",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "AI Gateway adalah jembatan manajemen terpusat yang menghubungkan aplikasi ke berbagai penyedia model AI secara efisien, aman, dan hemat biaya."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 28,
    "total_tokens": 44
  }
}