Langsung ke konten

Mage API · Model gambar

GPT Image 2 API

Prompt presisi dan teks yang terbaca jelas

POST https://api.mage.space/v1/gpt_image_2/generate

Sekilas info

API GPT Image 2 menjalankan GPT Image 2 dan 4 varian lainnya lewat Mage di POST https://api.mage.space/v1/gpt_image_2/generate. Satu permintaan dengan pengaturan default berharga 9 Gems (sekitar $0,009), tanpa langganan. GPT Image 2 mendukung karakter tersimpan dan referensi lewat @handle di dalam prompt.

  • GambarOutput
  • 5Varian
  • 9Gems per gambar, default
  • $0.009Perkiraan, dalam USD

Ringkasan

Apa yang bisa dilakukan GPT Image 2 API

Model GPT Image dari OpenAI, yang mengikuti prompt secara persis dan menghasilkan teks yang terbaca jelas. Buat atau edit gambar dari banyak gambar referensi, atau buat GIF animasi dengan GPT Image 2.6. Filter keamanan OpenAI berlaku.

Model GPT Image dari OpenAI untuk membuat dan mengedit gambar: GPT Image 2, GPT Image 2.5 Flare dan Sunburst, serta GPT Image 2.6 Flare dan Sunburst, yang juga bisa membuat GIF animasi. Filter keamanan OpenAI berlaku.

Menerima image dan additional_images sebagai input.

Mulai cepat

Panggil API GPT Image 2

Setel MAGE_API_KEY, kirim ke /gpt_image_2/generate, lalu lakukan polling ke status_url sampai permintaan selesai.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "gpt-image-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Model

Nilai model_id GPT Image 2

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
gpt-image-2GPT Image 2Ya
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Opsi

Parameter GPT Image 2

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Input

Input media yang didukung GPT Image 2

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.

Aturan

Aturan yang diterapkan API GPT Image 2

  • Setiap model hanya menyediakan level `quality` tertentu; level yang tidak tersedia di model yang dipilih akan ditolak.
  • Setel `output_format` ke `gif` pada model GPT Image 2.6 untuk mendapatkan GIF animasi, dengan `frame_count` dari 2 sampai 16 (default 9) dan `frame_duration_ms` dari 20 sampai 2000 (default 200). Model lain akan menolaknya. `resolution` tidak berlaku: setiap `aspect_ratio` punya satu ukuran frame, sekitar 640 piksel. Hasilnya berupa file `.gif`, dan `type`-nya tetap `image`.
  • Harga GIF ditentukan oleh `quality` dan rentang frame-nya (2 sampai 8, 9, 10 sampai 12, atau 13 sampai 16), bukan per frame. Tabel harga di bawah menampilkan gambar diam: lihat harga GIF pada estimasi biaya.
  • GIF di Mage, misalnya hasil sebelumnya, yang dimasukkan sebagai input gambar akan diproses menggunakan frame pertamanya. GIF dari sumber lain akan ditolak: input gambar harus berformat JPEG atau PNG.

Model gambar lainnya

API pembuat gambar lainnya di Mage

  • Gambar · mulai 90 Gems

    Grok Image API

    Grok Imagine, dalam dua tingkatan

  • Gambar · mulai dari 37 Gems

    Guava API

    Fotorealisme yang tampak seperti foto asli

  • Gambar · mulai 20 Gems

    HiDream API

    Cepat dan serbaguna, dengan negative prompt

  • Gambar · mulai 20 Gems

    Krea 2 API

    Estetika memukau dalam hitungan detik

  • Gambar · mulai dari 42 Gems

    Mango API

    Keluarga model gambar andalan kami

  • Gambar · mulai dari 15 Gems

    MiniMax H3 Image API

    Gambar native 16 megapiksel, open weights

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API GPT Image 2?
Satu permintaan GPT Image 2 dengan pengaturan default (GPT Image 2) berharga 9 Gems, sekitar $0,009. Resolusi, durasi, dan varian lain akan mengubah harganya; respons menampilkan biaya pastinya. Generasi yang gagal akan dikembalikan Gems-nya; generasi yang diblokir oleh kebijakan konten Mage tidak dikembalikan.
Apa endpoint API GPT Image 2?
POST https://api.mage.space/v1/gpt_image_2/generate dengan header Authorization: Bearer yang berisi kunci API Mage milikmu. Respons berisi status_url untuk di-polling guna mendapatkan hasilnya.
Model GPT Image 2 mana saja yang bisa kupanggil?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). Defaultnya adalah GPT Image 2.
Apakah GPT Image 2 mendukung gambar referensi atau karakter?
GPT Image 2 menerima image, additional_images. GPT Image 2 juga bisa memakai karakter dan referensi yang tersimpan lewat @handle di prompt.
Bisakah aku memakai GPT Image 2 dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta GPT Image 2 dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat gambar.
Berapa lama hasil GPT Image 2 disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.

Mulai berkarya dengan Mage

Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.

CharactersKomunitas