OpenAI Multimodal Responses API

curl https://api.apimart.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "model": "gpt-5",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What is in this image?"
          },
          {
            "type": "input_image",
            "image_url": "https://openai-documentation.vercel.app/images/cat_and_otter.png"
          }
        ]
      }
    ]
  }'

{
  "code": 200,
  "data": {
    "id": "resp-9876543210",
    "object": "response",
    "created": 1677652288,
    "model": "gpt-5",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "This image shows a cat and an otter. They appear to be interacting with each other in a very cute and heartwarming scene. The cat and otter seem to be getting along well."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 156,
      "completion_tokens": 45,
      "total_tokens": 201
    }
  }
}

POST

responses

curl https://api.apimart.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "model": "gpt-5",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What is in this image?"
          },
          {
            "type": "input_image",
            "image_url": "https://openai-documentation.vercel.app/images/cat_and_otter.png"
          }
        ]
      }
    ]
  }'

{
  "code": 200,
  "data": {
    "id": "resp-9876543210",
    "object": "response",
    "created": 1677652288,
    "model": "gpt-5",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "This image shows a cat and an otter. They appear to be interacting with each other in a very cute and heartwarming scene. The cat and otter seem to be getting along well."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 156,
      "completion_tokens": 45,
      "total_tokens": 201
    }
  }
}

curl https://api.apimart.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "model": "gpt-5",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "What is in this image?"
          },
          {
            "type": "input_image",
            "image_url": "https://openai-documentation.vercel.app/images/cat_and_otter.png"
          }
        ]
      }
    ]
  }'

{
  "code": 200,
  "data": {
    "id": "resp-9876543210",
    "object": "response",
    "created": 1677652288,
    "model": "gpt-5",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "This image shows a cat and an otter. They appear to be interacting with each other in a very cute and heartwarming scene. The cat and otter seem to be getting along well."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 156,
      "completion_tokens": 45,
      "total_tokens": 201
    }
  }
}

Otorisasi

Authorization

string

wajib

##Semua API memerlukan autentikasi Bearer Token##Dapatkan API Key:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:

Authorization: Bearer YOUR_API_KEY

Body

model

string

default:"gpt-5"

wajib

Nama modelModel yang didukung meliputi:

gpt-5 - Model multimodal terbaru OpenAI
GPT-4o-image - Model multimodal GPT-4 yang dioptimalkan
gpt-4-vision - Model GPT-4 untuk pemahaman vision
Model lainnya segera hadir…

input

array

wajib

Daftar konten inputArray input; setiap item berisi field role dan content.💡 Pengisian cepat (area Try it):

Klik ”+ Add an item” untuk menambahkan item input
Input role: user (pesan pengguna), assistant (respons AI), atau system (prompt sistem)
Tambahkan blok konten di content (dapat mencakup teks dan gambar)

Tampilkan Detail field

role

string

default:"user"

wajib

Jenis roleOpsi: user (pesan pengguna), assistant (respons AI, untuk multi-giliran), system (prompt sistem, untuk mengatur perilaku AI)

content

array

wajib

Array kontenMendukung berbagai jenis blok konten, termasuk teks dan gambar.

Tampilkan Jenis blok konten

type

string

wajib

Jenis kontenOpsi:

input_text: Input teks
input_image: Input gambar

text

string

Konten teksDigunakan saat type adalah input_text; isi dengan konten teks

image_url

string

URL gambarDigunakan saat type adalah input_image; isi dengan URL gambar atau encoding Base64Mendukung dua format:1. URL gambar lengkap

URL gambar yang dapat diakses publik (http:// atau https://)
Contoh: https://example.com/image.jpg

2. Format yang dikodekan Base64

Harus menggunakan format Data URI lengkap
Format: data:image/{format};base64,{base64_data}
Format gambar yang didukung: jpeg, png, gif, webp

temperature

number

Mengontrol keacakan output, rentang 0-2

Nilai yang lebih rendah (misalnya 0,2) membuat output lebih deterministik
Nilai yang lebih tinggi (misalnya 1,8) membuat output lebih acak

Default: 1.0

max_tokens

integer

Jumlah maksimum token yang akan dibuatSetiap model memiliki batas maksimum yang berbeda; lihat dokumentasi model terkait

stream

boolean

Apakah akan menggunakan output streaming

true: Respons streaming (format SSE)
false: Mengembalikan respons lengkap sekaligus

Default: false

top_p

number

Parameter nucleus sampling, rentang 0-1Mengontrol keragaman teks yang dihasilkan; sebaiknya digunakan sebagai alternatif temperatureDefault: 1.0

tools

array

Daftar tool untuk memperluas kemampuan modelJenis tool yang didukung:

Web Search (web_search): Pencarian informasi internet real-time
File Search (file_search): Mencari konten file yang diunggah
Function Calling (function): Memanggil fungsi kustom
Remote MCP (remote_mcp): Terhubung ke layanan Model Context Protocol jarak jauh

Contoh: [{"type": "web_search"}]

Respons

string

Pengidentifikasi unik untuk respons

object

string

Jenis objek, tetap sebagai response

created

integer

Timestamp pembuatan

model

string

Nama model aktual yang digunakan

choices

array

Daftar balasan yang dihasilkan

Tampilkan Properti

index

integer

Indeks pilihan

message

object

Konten pesan

Tampilkan Properti

role

string

Jenis role (assistant)

content

string

Konten teks yang dihasilkan

finish_reason

string

Alasan selesaiNilai yang mungkin:

stop - Selesai secara alami
length - Mencapai panjang maksimum
content_filter - Penyaringan konten

usage

object

Statistik penggunaan token

Tampilkan Properti

prompt_tokens

integer

Jumlah token dalam input

completion_tokens

integer

Jumlah token dalam output

total_tokens

integer

Jumlah total token

Contoh Penggunaan

Input Teks Saja

{
  "model": "gpt-5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Hello, introduce artificial intelligence"
        }
      ]
    }
  ]
}

Menggunakan Tool Web Search

{
  "model": "gpt-5",
  "tools": [{"type": "web_search"}],
  "input": "What positive news is there today?"
}

cURL Example

curl "https://api.apimart.ai/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
        "model": "gpt-5",
        "tools": [{"type": "web_search"}],
        "input": "What positive news is there today?"
    }'

Pemahaman Gambar

{
  "model": "gpt-5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Describe this image"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/image.jpg"
        }
      ]
    }
  ]
}

Analisis Multi-Gambar

{
  "model": "gpt-5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Compare the similarities and differences of these two images"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/image1.jpg"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/image2.jpg"
        }
      ]
    }
  ]
}

Gambar yang Dikodekan Base64

{
  "model": "gpt-5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Analyze this image"
        },
        {
          "type": "input_image",
          "image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
        }
      ]
    }
  ]
}

Menggunakan Tool File Search

{
  "model": "gpt-5",
  "tools": [{"type": "file_search"}],
  "input": "Based on uploaded documents, summarize the company's quarterly performance"
}

Menggunakan Function Calling

{
  "model": "gpt-5",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather information for a specified city",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "description": "City name, e.g.: Beijing"
            },
            "unit": {
              "type": "string",
              "enum": ["celsius", "fahrenheit"],
              "description": "Temperature unit"
            }
          },
          "required": ["city"]
        }
      }
    }
  ],
  "input": "What's the weather like in Beijing today?"
}

Menggunakan Remote MCP

{
  "model": "gpt-5",
  "tools": [
    {
      "type": "remote_mcp",
      "remote_mcp": {
        "url": "https://mcp.example.com/api",
        "auth_token": "your_mcp_token"
      }
    }
  ],
  "input": "Query user information in the database"
}

Menggabungkan Beberapa Tool

{
  "model": "gpt-5",
  "tools": [
    {"type": "web_search"},
    {"type": "file_search"},
    {
      "type": "function",
      "function": {
        "name": "calculate",
        "description": "Perform mathematical calculations",
        "parameters": {
          "type": "object",
          "properties": {
            "expression": {
              "type": "string",
              "description": "Mathematical expression"
            }
          },
          "required": ["expression"]
        }
      }
    }
  ],
  "input": "Search for the latest Bitcoin price and calculate the total value of 100 Bitcoins"
}

Spesifikasi Jenis Konten

input_text

Jenis input teks Properti:

type: Tetap sebagai "input_text"
text: Konten teks (string)

input_image

Jenis input gambar Properti:

type: Tetap sebagai "input_image"
image_url: URL gambar atau data URI yang dikodekan Base64

Format gambar yang didukung:

JPEG
PNG
GIF
WebP

Batas ukuran gambar:

Ukuran file maksimum: 20MB
aspect_ratio yang disarankan: tidak lebih dari 2048x2048 piksel

Detail Penggunaan Tool

Web Search

Tool web search memungkinkan model mengakses informasi internet real-time. Contoh konfigurasi:

{
  "tools": [{"type": "web_search"}]
}

Kasus penggunaan:

Menanyakan berita terbaru dan peristiwa terkini
Mendapatkan data real-time (saham, cuaca, nilai tukar, dan sebagainya)
Mencari dokumentasi teknis terbaru
Memverifikasi informasi faktual

File Search

Tool file search memungkinkan model mencari informasi relevan dalam dokumen yang diunggah. Contoh konfigurasi:

{
  "tools": [{"type": "file_search"}]
}

Kasus penggunaan:

Menganalisis dokumen internal perusahaan
Mencari spesifikasi teknis dan manual
Menanyakan kontrak dan dokumen hukum
Sistem tanya jawab basis pengetahuan

Function Calling

Definisikan fungsi kustom agar model dapat memanggil API eksternal atau menjalankan operasi tertentu. Contoh konfigurasi lengkap:

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_stock_price",
        "description": "Get real-time stock price",
        "parameters": {
          "type": "object",
          "properties": {
            "symbol": {
              "type": "string",
              "description": "Stock symbol, e.g.: AAPL"
            },
            "currency": {
              "type": "string",
              "enum": ["USD", "CNY"],
              "description": "Currency unit",
              "default": "USD"
            }
          },
          "required": ["symbol"]
        }
      }
    }
  ]
}

Deskripsi parameter:

name: Nama fungsi (wajib)
description: Deskripsi fungsi (wajib)
parameters: Definisi parameter menggunakan format JSON Schema
- type: Jenis parameter
- properties: Definisi properti parameter
- required: Daftar parameter wajib

Kasus penggunaan:

Memanggil API pihak ketiga
Menjalankan kueri basis data
Memicu proses bisnis
Berintegrasi dengan sistem internal

Remote MCP

Terhubung ke layanan Model Context Protocol (MCP) jarak jauh untuk memperluas kemampuan model. Contoh konfigurasi:

{
  "tools": [
    {
      "type": "remote_mcp",
      "remote_mcp": {
        "url": "https://your-mcp-server.com/api",
        "auth_token": "your_auth_token",
        "timeout": 30
      }
    }
  ]
}

Deskripsi parameter:

url: Alamat server MCP (wajib)
auth_token: Token autentikasi (opsional)
timeout: Timeout dalam detik, default 30 detik

Kasus penggunaan:

Terhubung ke layanan AI tingkat enterprise
Menggunakan model khusus domain
Mengakses sumber data terlindungi
Integrasi sistem AI terdistribusi

Format Respons Tool

Saat model menggunakan tool, format respons akan menyertakan informasi pemanggilan tool:

{
  "id": "resp-123456",
  "object": "response",
  "created": 1677652288,
  "model": "gpt-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_abc123",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"city\": \"Beijing\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}

Alur kerja pemanggilan tool:

Model menerima input pengguna
Menganalisis apakah tool diperlukan
Jika diperlukan, mengembalikan request pemanggilan tool
Klien menjalankan pemanggilan tool
Mengembalikan hasil tool ke model
Model menghasilkan respons akhir

Catatan Penting

Persyaratan URL gambar:
- Harus berupa URL yang dapat diakses publik
- Atau gunakan format Data URI yang dikodekan Base64
Penagihan token:
- Gambar mengonsumsi token berdasarkan aspect_ratio
- Gambar dengan aspect_ratio tinggi akan diubah ukurannya secara otomatis untuk mengoptimalkan biaya
- Pemanggilan tool juga mengonsumsi token tambahan
Urutan konten:
- Urutan elemen dalam array konten memengaruhi pemahaman model
- Disarankan menempatkan instruksi teks terlebih dahulu, lalu gambar
Kombinasi multimodal:
- Dapat mencampur beberapa teks dan gambar dalam satu request
- Mendukung percakapan multi-giliran dengan koherensi konteks
Batasan penggunaan tool:
- Saat beberapa tool digunakan sekaligus, model akan memilih tool yang paling sesuai secara cerdas
- Function calling memerlukan definisi fungsi dan deskripsi parameter yang jelas
- Hasil web search dapat dibatasi oleh wilayah dan waktu
Kompatibilitas API:
- Sepenuhnya kompatibel dengan format OpenAI Responses API
- Memigrasikan kode OpenAI yang sudah ada dengan lancar
- Mendukung semua fitur ekstensi tool OpenAI

Format Native Gemini Gemini-3.1-Flash-Image-preview (Nano banana2) Pembuatan Gambar

Documentation Index

​Otorisasi

​Body

​Respons

​Contoh Penggunaan

​Input Teks Saja

​Menggunakan Tool Web Search

​Pemahaman Gambar

​Analisis Multi-Gambar

​Gambar yang Dikodekan Base64

​Menggunakan Tool File Search

​Menggunakan Function Calling

​Menggunakan Remote MCP

​Menggabungkan Beberapa Tool

​Spesifikasi Jenis Konten

​input_text

​input_image

​Detail Penggunaan Tool

​Web Search

​File Search

​Function Calling

​Remote MCP

​Format Respons Tool

​Catatan Penting

Otorisasi

Body

Respons

Contoh Penggunaan

Input Teks Saja

Menggunakan Tool Web Search

Pemahaman Gambar

Analisis Multi-Gambar

Gambar yang Dikodekan Base64

Menggunakan Tool File Search

Menggunakan Function Calling

Menggunakan Remote MCP

Menggabungkan Beberapa Tool

Spesifikasi Jenis Konten

input_text

input_image

Detail Penggunaan Tool

Web Search

File Search

Function Calling

Remote MCP

Format Respons Tool

Catatan Penting