Panduan Integrasi API Gateway AI Studio

{
  "model": "gemini-3-1-flash",
  "messages": [
    {
      "role": "system",
      "content": "Anda adalah asisten AI profesional dan ahli rekayasa perangkat lunak."
    },
    {
      "role": "user",
      "content": "Jelaskan konsep microservices secara singkat!"
    }
  ],
  "temperature": 0.7,
  "stream": false
}

{
  "id": "chatcmpl-a9f82d1c7e90",
  "object": "chat.completion",
  "created": 1724567890,
  "model": "gemini-3-1-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Microservices adalah pendekatan arsitektur di mana aplikasi dibangun sebagai kumpulan modul layanan kecil yang independen..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 120,
    "total_tokens": 148
  }
}

{
  "model": "gemini-3-1-flash",
  "messages": [
    {
      "role": "user",
      "content": "Tuliskan 3 tips produktivitas kerja sehari-hari!"
    }
  ],
  "stream": true
}

data: {"id":"chatcmpl-09370f0f5173","object":"chat.completion.chunk","created":1789288684,"model":"gemini-3.7-flash","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl-09370f0f5173","object":"chat.completion.chunk","created":1789288684,"model":"gemini-3.7-flash","choices":[{"index":0,"delta":{"content":"Berikut "},"finish_reason":null}]}

data: {"id":"chatcmpl-09370f0f5173","object":"chat.completion.chunk","created":1789288684,"model":"gemini-3.7-flash","choices":[{"index":0,"delta":{"content":"3 tips "},"finish_reason":null}]}

data: {"id":"chatcmpl-09370f0f5173","object":"chat.completion.chunk","created":1789288684,"model":"gemini-3.7-flash","choices":[{"index":0,"delta":{"content":"produktivitas..."},"finish_reason":null}]}

data: [DONE]

{
  "model": "gemini-3-1-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Analisa gambar berikut dan jelaskan grafik penjualan yang ada di dalamnya secara detail."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAP//////////////////////////////////////////////////////////////////////////////////////wgALCAABAAEBAREA/8QAFBABAAAAAAAAAAAAAAAAAAAAAP/aAAgBAQABPxA="
          }
        }
      ]
    }
  ],
  "temperature": 0.5
}

{
  "model": "gemini-3-1-flash",
  "session_id": "conv_client_001",
  "system_prompt": "Anda adalah konsultan bisnis profesional.",
  "messages": [
    {
      "role": "user",
      "content": "Halo! Perusahaan saya bernama PT Maju Makmur berbasis di Surabaya."
    }
  ]
}

{
  "model": "gemini-3-1-flash",
  "session_id": "conv_client_001",
  "messages": [
    {
      "role": "user",
      "content": "Sebutkan nama perusahaan saya dan di kota mana saya berbasis?"
    }
  ]
}

{
  "model": "gemini-3-1-flash",
  "session_id": "conv_client_001",
  "message": "Apa rekomendasi strategi ekspansi bisnis untuk perusahaan saya?"
}

# 1. Mendapatkan daftar seluruh sesi obrolan Anda:
curl -X GET "https://aistudio.id/v1/chat/sessions" \
  -H "Authorization: Bearer API_KEY_MILIKMU"

# 2. Mengambil riwayat pesan lengkap dari sebuah sesi:
curl -X GET "https://aistudio.id/v1/chat/sessions?session_id=conv_client_001" \
  -H "Authorization: Bearer API_KEY_MILIKMU"

# 3. Menghapus sesi obrolan beserta seluruh riwayat pesannya:
curl -X DELETE "https://aistudio.id/v1/chat/sessions?session_id=conv_client_001" \
  -H "Authorization: Bearer API_KEY_MILIKMU"

{
  "model": "banana-pro",
  "prompt": "Modern coffee shop interior with wooden minimalist aesthetics, warm sunlight through large window, plants, highly detailed 8k photography",
  "size": "1024x1024",
  "aspect_ratio": "16:9",
  "response_format": "url",
  "n": 1
}

{
  "success": true,
  "created": 1724567920,
  "model": "banana-pro",
  "data": [
    {
      "url": "https://aistudio.id/uploads/ai_gallery/images/img_1724567920_ab12cd.png",
      "revised_prompt": "Modern coffee shop interior with wooden minimalist aesthetics..."
    }
  ]
}

{
  "model": "banana-pro",
  "prompt": "Ganti kostum karakter dari foto acuan menjadi pakaian Cyberpunk dan latar belakang kota Tokyo masa depan malam hari",
  "image_references": [
    "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  ],
  "aspect_ratio": "1:1",
  "response_format": "url"
}

curl -X POST "https://aistudio.id/v1/images/generations" \
  -H "Authorization: Bearer aist-af675da7a8355c09d8d11ebdc517de15" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt_imagev2",
    "prompt": "Cyberpunk barista robot pouring glowing neon latte in a rainy Tokyo alley coffee shop, cinematic lighting, 8k photography, ultra detailed",
    "aspect_ratio": "9:16",
    "size": "1024x1792",
    "response_format": "url",
    "n": 1
  }'

curl -X POST "https://aistudio.id/v1/images/generations" \
  -H "Authorization: Bearer aist-af675da7a8355c09d8d11ebdc517de15" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt_imagev2",
    "prompt": "Pertahankan wajah karakter dari foto referensi 1, padukan dengan pose dari referensi 2 dan warna kostum pada referensi 3. Beri latar belakang istana megah bersalju.",
    "aspect_ratio": "16:9",
    "image_references": [
      "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD...",
      "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD...",
      "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    ],
    "response_format": "url"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="aist-af675da7a8355c09d8d11ebdc517de15",
    base_url="https://aistudio.id/v1"
)

# Pemanggilan Generate Gambar Gpt_imagev2
response = client.images.generate(
    model="gpt_imagev2",
    prompt="Kucing putih bermahkota emas duduk di singgasana batu permata, gaya lukisan Renaissance, 8k",
    size="1024x1024",
    n=1
)

# Ambil URL hasil gambar yang telah tersimpan di server
image_url = response.data[0].url
print("URL Gambar AI:", image_url)

<?php
$apiKey = 'aist-af675da7a8355c09d8d11ebdc517de15';
$endpoint = 'https://aistudio.id/v1/images/generations';

$payload = [
    'model'        => 'gpt_imagev2',
    'prompt'       => 'Pemandangan sawah terasering di Bali saat fajar matahari terbit, kabut pagi lembut, ultra-photorealistic',
    'aspect_ratio' => '16:9',
    'size'         => '1792x1024',
    'response_format' => 'url'
];

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_TIMEOUT        => 180, // Rekomendasi timeout 180s untuk proses render gambar
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {$apiKey}",
        "Content-Type: application/json"
    ],
    CURLOPT_SSL_VERIFYPEER => false
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if (!empty($result['data'][0]['url'])) {
    echo "Gambar Berhasil Dibuat: " . $result['data'][0]['url'] . PHP_EOL;
} else {
    echo "Gagal: " . ($result['error']['message'] ?? 'Unknown Error') . PHP_EOL;
}
?>

curl -X POST "https://aistudio.id/v1/images/generations" \
  -H "Authorization: Bearer aist-af675da7a8355c09d8d11ebdc517de15" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt_imagev2",
    "prompt": "Futuristic electric supercar on wet asphalt street, cinematic neon reflections, 8k",
    "aspect_ratio": "16:9",
    "async": true
  }'

{
  "success": true,
  "ok": true,
  "job_id": "a1e7bbdaffc94ea6aefbe50be8b3023a",
  "status": "queued",
  "model": "gpt_imagev2",
  "poll_url": "https://aistudio.id/v1/images/status/a1e7bbdaffc94ea6aefbe50be8b3023a",
  "message": "Permintaan pembuatan gambar ChatGPT berhasil didaftarkan ke antrean."
}

curl -X GET "https://aistudio.id/v1/images/status/a1e7bbdaffc94ea6aefbe50be8b3023a" \
  -H "Authorization: Bearer aist-af675da7a8355c09d8d11ebdc517de15"

{
  "success": true,
  "status": "done",
  "job_id": "a1e7bbdaffc94ea6aefbe50be8b3023a",
  "model": "gpt_imagev2",
  "duration_s": 58.4,
  "data": [
    {
      "url": "https://aistudio.id/uploads/creations/images/img_gpt_1790532938_a1e7bb.png",
      "revised_prompt": "Futuristic electric supercar on wet asphalt street..."
    }
  ],
  "image_url": "https://aistudio.id/uploads/creations/images/img_gpt_1790532938_a1e7bb.png"
}

curl -X GET "https://aistudio.id/v1/images/status" \
  -H "Authorization: Bearer aist-af675da7a8355c09d8d11ebdc517de15"

{
  "model": "tts-1",
  "input": "Halo, selamat datang di platform AI Studio Indonesia.",
  "voice": "Paijah",
  "intonation": "Ceria, penuh semangat, dan antusias",
  "speed": 1.0,
  "response_format": "json"
}

curl -X POST https://aistudio.id/v1/video/generations \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google-omni",
    "mode": "t2v",
    "prompt": "Sebuah kapal layar megah melintasi samudera luas saat kabut fajar terbelah sinar matahari keemasan",
    "ratio": 1
  }'

curl -X POST https://aistudio.id/v1/video/generations \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google-omni",
    "mode": "sfv",
    "prompt": "Mulai dari foto ini, kamera zoom dinamis mengikuti langkah karakter ke dalam ruangan bernuansa neon",
    "ratio": 1,
    "media": [
      "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    ]
  }'

curl -X POST https://aistudio.id/v1/video/generations \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google-omni",
    "mode": "i2v",
    "prompt": "Animasi dinamis mempertemukan kedua karakter dari foto acuan di jalanan Tokyo masa depan",
    "ratio": 1,
    "media": [
      "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
      "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    ]
  }'

GET https://aistudio.id/v1/video/generations/4a48e371c9d24f5ba1e83b77d2c05e19
Header: Authorization: Bearer API_KEY_MILIKMU

const fs = require('fs');

const API_BASE = 'https://aistudio.id/v1';
const API_KEY = 'API_KEY_MILIKMU';

async function generateOmniVideo() {
  // 1. Submit Job Google Omni
  const submitRes = await fetch(`${API_BASE}/video/generations`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'google-omni',
      mode: 't2v',
      prompt: 'Sebuah kapal layar mengarungi lautan lepas saat matahari terbit',
      ratio: 1 // 1 = 16:9 Landscape, 2 = 9:16 Portrait
    })
  });
  const submitData = await submitRes.json();
  console.log('Tiket Job Omni:', submitData.job_id);

  // 2. Polling status setiap 3 detik hingga selesai
  let jobData;
  while (true) {
    const pollRes = await fetch(`${API_BASE}/video/generations/${submitData.job_id}`, {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    });
    jobData = await pollRes.json();
    console.log(`Status render: ${jobData.status}...`);

    if (jobData.status === 'done' || jobData.status === 'failed') break;
    await new Promise(r => setTimeout(r, 3000));
  }

  // 3. Download hasil video MP4 jika sukses
  if (jobData.status === 'done' && jobData.outputs && jobData.outputs.length > 0) {
    const downloadUrl = jobData.outputs[0].download_url;
    console.log('Mengunduh video dari:', downloadUrl);

    const vidRes = await fetch(downloadUrl, {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    });
    const buffer = Buffer.from(await vidRes.arrayBuffer());
    fs.writeFileSync('output_omni.mp4', buffer);
    console.log('✅ Video berhasil disimpan ke file output_omni.mp4');
  } else {
    console.error('❌ Render video gagal:', jobData.error || 'Unknown error');
  }
}

generateOmniVideo();

curl -X POST "https://aistudio.id/v1/media/upscale/image" \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -F "file=@/path/ke/foto_input.jpg" \
  -F "target=4k" \
  -F "format=png" \
  -F "quality=95"

{
  "success": true,
  "action": "v1_media_upscale_image",
  "model": "image-upscale",
  "media_type": "image",
  "media_url": "https://aistudio.id/uploads/creations/images/2026-10/media_1724567920_ab12cd.png",
  "download_url": "https://aistudio.id/uploads/creations/images/2026-10/media_1724567920_ab12cd.png",
  "coins_deducted": 1.00,
  "coins_remaining": 98,
  "execution_time_ms": 2340,
  "meta": {
    "target": "4k",
    "format": "png",
    "quality": 95
  }
}

curl -X POST "https://aistudio.id/v1/media/upscale/video" \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -F "file=@/path/ke/video_720p.mp4" \
  -F "target=2k" \
  -F "speed=fast" \
  -F "sharpen=medium"

{
  "success": true,
  "action": "v1_media_upscale_video",
  "model": "video-upscale",
  "media_type": "video",
  "media_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724567950_8f90ea.mp4",
  "download_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724567950_8f90ea.mp4",
  "coins_deducted": 5.00,
  "coins_remaining": 93,
  "execution_time_ms": 14500,
  "meta": {
    "target": "2k",
    "speed": "fast",
    "sharpen": "medium"
  }
}

curl -X POST "https://aistudio.id/v1/media/merge" \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -F "videos[]=@klip_bagian_1.mp4" \
  -F "videos[]=@klip_bagian_2.mp4" \
  -F "videos[]=@klip_bagian_3.mp4"

{
  "success": true,
  "action": "v1_media_merge_video",
  "model": "video-merge",
  "media_type": "video",
  "media_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724567990_merged.mp4",
  "download_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724567990_merged.mp4",
  "coins_deducted": 5.00,
  "coins_remaining": 92,
  "execution_time_ms": 680,
  "meta": {
    "videos_count": 3,
    "merge_mode": "concat_instant"
  }
}

curl -X POST "https://aistudio.id/v1/media/anti-duplicate" \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -F "file=@/path/ke/video_sumber.mp4" \
  -F "mode=medium" \
  -F "strip_metadata=1" \
  -F "noise=1" \
  -F "mirror=0" \
  -F "cut_head=0"

{
  "success": true,
  "action": "v1_media_antidup_video",
  "model": "video-antidup",
  "media_type": "video",
  "media_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724568010_antidup.mp4",
  "download_url": "https://aistudio.id/uploads/creations/videos/2026-10/media_1724568010_antidup.mp4",
  "coins_deducted": 5.00,
  "coins_remaining": 89,
  "execution_time_ms": 4210,
  "meta": {
    "mode": "medium",
    "strip_metadata": 1,
    "noise": 1,
    "mirror": 0,
    "cut_head": 0
  }
}

// 1. Upload File Gambar dari input file HTML
const fileInput = document.querySelector('input[type="file"]');
const formData = new FormData();
formData.append('file', fileInput.files[0]);

const uploadRes = await fetch('https://aistudio.id/v1/media/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer API_KEY_MILIKMU'
  },
  body: formData
});

const fileData = await uploadRes.json();
console.log('URL Publik Gambar:', fileData.url);

// 2. Kirim URL Publik tersebut langsung ke endpoint Vision / Chat
const chatRes = await fetch('https://aistudio.id/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer API_KEY_MILIKMU'
  },
  body: JSON.stringify({
    model: 'gemini-3-1-flash',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Tolong analisa foto yang baru saya upload ini:' },
          { type: 'image_url', image_url: { url: fileData.url } }
        ]
      }
    ]
  })
});

const chatData = await chatRes.json();
console.log(chatData.choices[0].message.content);

curl -X POST https://aistudio.id/v1/media/upload \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -F "file=@/path/to/foto_produk.jpg"

{
  "success": true,
  "url": "https://aistudio.id/uploads/temp_media/media_1724567890_9a8b7c6d5e4f3a2b.jpg",
  "public_url": "https://aistudio.id/uploads/temp_media/media_1724567890_9a8b7c6d5e4f3a2b.jpg",
  "filename": "media_1724567890_9a8b7c6d5e4f3a2b.jpg",
  "original_name": "foto_produk.jpg",
  "mime_type": "image/jpeg",
  "size_bytes": 1048576,
  "created_at": "2026-08-26T11:20:00+07:00",
  "expires_at": "2026-08-27T11:20:00+07:00",
  "expires_in_seconds": 86400,
  "note": "Media publik tersimpan selama 24 jam dan siap digunakan langsung sebagai URL pada endpoint AI."
}

# Gunakan flag -N / --no-buffer agar cURL langsung menampilkan stream kata demi kata
curl -N https://aistudio.id/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "Authorization: Bearer API_KEY_MILIKMU" \
  -d '{
    "model": "gemini-3-1-flash",
    "messages": [
      {"role": "user", "content": "Halo, buatkan puisi pendek tentang teknologi AI!"}
    ],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://aistudio.id/v1",
    api_key="API_KEY_MILIKMU"  # Ganti dengan API Key Anda
)

# 1. Contoh Mode Streaming (stream=True)
stream = client.chat.completions.create(
    model="gemini-3-1-flash",
    messages=[
        {"role": "system", "content": "Anda adalah asisten AI yang cerdas."},
        {"role": "user", "content": "Jelaskan cara kerja neural network secara singkat!"}
    ],
    stream=True  # <-- Cukup set stream=True
)

for chunk in stream:
    token = chunk.choices[0].delta.content or ""
    print(token, end="", flush=True)

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://aistudio.id/v1',
  apiKey: process.env.AISTUDIO_API_KEY || 'API_KEY_MILIKMU',
});

async function run() {
  const stream = await openai.chat.completions.create({
    model: 'gemini-3-1-flash',
    messages: [{ role: 'user', content: 'Halo AI Studio!' }],
    stream: true, // <-- Streaming aktif
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

run();

// Konsumsi streaming respons token-demi-token langsung di browser
async function streamChat(promptText) {
  const apiKey = "API_KEY_MILIKMU"; // Ganti dengan API Key Anda

  const response = await fetch("https://aistudio.id/v1/chat/completions", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Accept": "text/event-stream",
      "Authorization": `Bearer ${apiKey}`
    },
    body: JSON.stringify({
      model: "gemini-3-1-flash",
      messages: [{ role: "user", content: promptText }],
      stream: true // <-- Set true untuk SSE
    })
  });

  const reader = response.body.getReader();
  const decoder = new TextDecoder("utf-8");
  let buffer = "";

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    buffer += decoder.decode(value, { stream: true });
    const lines = buffer.split("\n");
    buffer = lines.pop(); // simpan baris belum selesai

    for (const rawLine of lines) {
      const line = rawLine.trim();
      if (!line || line.startsWith(":") || line === "data: [DONE]") continue;
      if (line.startsWith("data: ")) {
        try {
          const json = JSON.parse(line.slice(6));
          const delta = json.choices?.[0]?.delta?.content || "";
          if (delta) {
            document.getElementById("outputChatBox").innerText += delta;
          }
        } catch (e) {}
      }
    }
  }
}

<?php
$apiKey = "API_KEY_MILIKMU";
$ch = curl_init("https://aistudio.id/v1/chat/completions");

$payload = [
    "model" => "gemini-3-1-flash",
    "messages" => [
        ["role" => "user", "content" => "Halo dari PHP! Tuliskan tips coding rapi."]
    ],
    "stream" => true // <-- Mengaktifkan SSE
];

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: text/event-stream",
        "Authorization: Bearer " . $apiKey
    ],
    // Tampilkan chunk teks seketika saat tiba dari server
    CURLOPT_WRITEFUNCTION => function($ch, $chunk) {
        echo $chunk;
        flush();
        return strlen($chunk);
    }
]);

curl_exec($ch);
curl_close($ch);
?>