wan2.7-imageAPI

Gunakan ID model yang tepat wan2.7-image. Bidang model harus sama persis dengan halaman ini.

Contoh keluaranwan2.7-imagePOST /v1/images/generations

Parameter: size=1536x1024n=1

Prompt: A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.

Permintaan yang menghasilkan sampel ini

{
  "model": "wan2.7-image",
  "prompt": "A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

Otentikasi dan titik akhir

Gunakan kunci API Modelflare dengan https://modelflare.dev/v1. Titik masuk gateway adalah POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Menghasilkan gambar

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

Minta catatan

Model gambar yang kompatibel dengan OpenAI menggunakan prompt, n, size, dan quality; gunakan pengeditan hanya ketika halaman resmi mendokumentasikannya.

Parameter permintaan

Wan2.7 Image / Pro menggunakan API Gambar sinkron. Gunakan bentuk datar yang kompatibel dengan OpenAI untuk panggilan sederhana; gunakan input.messages plus parameters untuk multi-gambar, pengeditan wilayah, dan pembuatan berurutan. Pro text-to-image mendukung hingga 4K di luar mode berurutan; model standar mendukung hingga 2K.

Bidang	Wajib diisi	Catatan
model	Ya	wan2.7-image
prompt	Ya	Instruksi pembuatan atau pengeditan
image	Tidak	URL gambar tunggal/Base64; gunakan input.messages hingga 9 gambar
input.messages	Tidak	Pesan bertingkat untuk multi-gambar, pengeditan wilayah, dan pembuatan berurutan
size	Tidak	1K / 2K; Pro teks-ke-gambar non-sekuensial juga mendukung 4K
n	Tidak	1–4 untuk generasi biasa; 1–12 untuk generasi berurutan; ditagih per gambar yang berhasil
thinking_mode	Tidak	Mode berpikir ketika tidak ada gambar yang diberikan
watermark	Tidak	Apakah akan menambahkan tanda air
parameters.prompt_extend	Tidak	Ekspansi cepat, default benar;
parameters.bbox_list	Tidak	Kotak wilayah pengeditan interaktif
parameters.enable_sequential	Tidak	Aktifkan pembuatan berurutan
parameters.color_palette	Tidak	3–10 warna HEX dengan persentase total 100%

Batas respons dan masukan

Gunakan bentuk datar untuk panggilan sederhana; gunakan input.messages dan parameters untuk multi-gambar, pengeditan wilayah, dan pembuatan berurutan. Mendukung hingga 9 gambar masukan, masing-masing berukuran di bawah 20 MB, 240–8.000 piksel per tepi, dengan rasio aspek 1:8 hingga 8:1. Jumlah keluaran biasa adalah 1–4 dan jumlah keluaran berurutan adalah 1–12; Text-to-image pro mendukung 4K di luar mode sekuensial, sementara kombinasi lainnya mencapai 2K.

Contoh alur kerja yang terdokumentasi

Wan2.7 Gambar mendukung bentuk datar dan bentuk input.messages/parameters bertumpuk; gunakan bentuk bersarang untuk multi-gambar, pengeditan wilayah, dan pembuatan berurutan.

Pengeditan multi-gambar

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/person.png"},
      {"image": "https://example.com/background.png"},
      {"text": "将图 1 中的人物放入图 2 的场景中"}
    ]}], "parameters": {"size": "2K", "n": 1, "prompt_extend": true}}
  }'

Pengeditan wilayah interaktif

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image", "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/room.png"},
      {"text": "将选中区域的花瓶替换成红玫瑰"}
    ]}], "parameters": {"size": "2K", "n": 1, "bbox_list": [[[420, 280, 760, 720]]]}}
  }'

Grup gambar berurutan

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image", "input": {"messages": [{"role": "user", "content": [{"text": "生成四张角色一致的季节分镜"}]}]},
    "parameters": {"size": "2K", "enable_sequential": true, "n": 4, "watermark": false}
  }'

Kesalahan dan tugas yang gagal

Parameter model yang tidak valid mengembalikan 4xx dengan ID permintaan; gunakan bidang respons dan pesan kesalahan yang ditentukan oleh kontrak model yang dipilih.

Cakupan yang didukung

Halaman ini mencakup pembuatan model Modelflare dan panggilan pengeditan. Pengayaan penelusuran atau peta, pengelolaan suara, dan pengelolaan pustaka elemen merupakan API sumber daya di luar permukaan panggilan model publik ini dan bukan merupakan bidang permintaan yang wajib diisi.

Pricing and billing

Model ini menggunakan penagihan per panggilan. Lihat halaman harga model untuk harga pelanggan saat ini, harga daftar referensi, dan spesifikasi lengkap.

Catatan

Halaman ini mendokumentasikan antarmuka publik Modelflare; bidang dan batasan yang ditampilkan di sini adalah kontrak saat ini.

Varian

ID Model	Perbedaan
wan2.7-image	Model didokumentasikan di halaman ini.