Pembuatan gambar

POST /v1/images/generations menerima format request gambar OpenAI dan mengembalikan format response gambar OpenAI, sehingga SDK openai dapat digunakan dengannya cukup dengan mengganti base URL.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.inferray.com/v1",
  apiKey: process.env.INFERRAY_API_KEY,
});

const result = await client.images.generate({
  model: "gemini-3-pro-image-preview",
  prompt: "a quartz crystal on a workbench, studio lighting",
  n: 1,
});

console.log(result.data[0].b64_json);

curl https://api.inferray.com/v1/images/generations \
  -H "Authorization: Bearer $INFERRAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "a quartz crystal on a workbench, studio lighting",
    "n": 1
  }'

Model gambar punya jalurnya sendiri

Model gambar hanya merespons di endpoint ini. Mengirim model gambar ke /v1/chat/completions, /v1/responses, atau /v1/messages akan mengembalikan 404 yang menyebutkan model-model yang memang dilayani endpoint tersebut, dan hal yang sama berlaku sebaliknya: model teks di endpoint ini akan ditolak, bukan diteruskan.

Halaman model menandai model mana saja yang dapat membuat gambar, dan GET /v1/models mencantumkannya bersama model teks.

Termasuk dalam Token Plan

Pembuatan gambar sudah termasuk dalam Token Plan. Setiap gambar memotong kredit Token Plan Anda sesuai harga resmi model, sama seperti request teks, sehingga Anda mendapatkan penggunaan 3× yang sama. Key dari project pay-as-you-go juga dapat digunakan di sini.

Cara kerja harga gambar

Harga model teks dinyatakan per 1M token. Model gambar tidak demikian, dan para penyedia tidak menggunakan satu satuan yang sama:

Model	Ditagih	Yang Anda lihat
`gemini-3-pro-image-preview`	Per gambar yang dihasilkan, berdasarkan resolusi	`$0.10 / image` pada 1K dan 2K, lebih mahal pada 4K
`gpt-image-2`	Per 1M token output gambar	Harga per token, karena tidak ada angka per gambar yang dipublikasikan
`gemini-2.5-flash-image`	Per token, seperti model teks	Harga token input dan output standar

Halaman setiap model menampilkan satuan yang benar-benar digunakan model tersebut untuk penagihan, dengan tarif yang Anda bayar. Tanpa biaya gateway yang ditambahkan di atasnya, sama seperti di tempat lain.

Yang ditagihkan kepada Anda

Tagihan Anda adalah biaya yang benar-benar timbul dari request, sesuai tarif yang ditampilkan untuk model tersebut. Tidak ada yang diestimasi dari prompt, dan tidak ada yang dibulatkan ke atas menjadi angka per gambar ketika penyedia menagih per token. Karena itulah resolusi yang Anda minta memengaruhi harga pada model yang menetapkan harga berdasarkan resolusi: gambar 4K memang lebih mahal untuk dihasilkan dibanding gambar 1K.

Streaming

Endpoint ini tidak memiliki mode streaming. Request gambar mengembalikan hasil satu kali, berisi gambar yang sudah jadi.