Zhipu: CogView 4
CogView 4 adalah model teks ke gambar dari Zhipu, tersedia di Ailoot Ultra dengan ID persis cogview-4. Berikan deskripsi adegan untuk membuat ilustrasi, latar produk, atau konsep visual. Kontrol yang didokumentasikan mencakup ukuran gambar, kualitas standard atau hd, dan watermark_enabled; respons menyediakan URL gambar yang semuanya perlu disimpan.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
CogView 4 mengubah arahan gambar tertulis menjadi keluaran gambar. Pilih cogview-4 di POST /v1/images/generations dan berikan prompt sebagai string teks. Masukan yang wajib adalah model dan prompt. Gunakan arahan untuk menjelaskan subjek utama, penempatannya, adegan di sekelilingnya, dan gaya visual yang ingin Anda evaluasi.
Untuk latar produk, jelaskan objek, permukaan di bawahnya, latar belakang, dan arah cahaya. Untuk ilustrasi, tentukan karakter atau objek, suasana yang diinginkan, dan komposisinya. Jika gambar akan ditempatkan di samping judul atau deskripsi produk, sebutkan bagian komposisi yang perlu menyisakan ruang kosong. Tinjau hasil terhadap kebutuhan konkret tersebut sebelum menggunakannya dalam tata letak.
Panduan size khusus CogView mencantumkan 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, dan 720x1440. Panduan ukuran kustom menetapkan setiap sisi antara 512 dan 2048 piksel, habis dibagi 16, dengan jumlah keseluruhan maksimal 2^21 piksel. Sesuaikan pembingkaian dengan penempatannya: ilustrasi potret, adegan produk persegi, dan visual lebar membutuhkan komposisi yang berbeda sekaligus dimensi yang berbeda.
quality menerima standard atau hd, dengan standard sebagai nilai bawaan CogView yang didokumentasikan. watermark_enabled adalah boolean dengan nilai bawaan true yang didokumentasikan. String user_id yang opsional mengidentifikasi pengguna akhir dan harus berisi 6 hingga 128 karakter. Pisahkan pengenal tersebut dari prompt kreatif. Perubahan kualitas atau ukuran harus disertai tujuan penggunaan gambar yang jelas, bukan menggantikan deskripsi tentang hal yang perlu ditampilkan.
Pembuatan gambar mengembalikan respons JSON sinkron yang berisi created dan data. Setiap item data[] menyediakan url. Unduh setiap gambar yang dikembalikan dan simpan respons beserta arahan dan pengaturan yang dipilih; jangan hanya menyimpan item pertama karena pratinjau menampilkan satu gambar. Kontrak yang didokumentasikan tidak menambahkan langkah polling tugas terpisah seperti pada video untuk permintaan gambar ini. Jika respons terputus atau tidak lengkap, simpan informasi permintaan asli dan hasil yang diterima sebelum memutuskan apakah permintaan pembuatan tambahan sesuai. Ailoot menyimpan gambar ini sebagai aset media milik pengguna dan mengembalikan tautan Ailoot bertanda tangan. Temukan catatan aset melalui GET /v1/media/assets?family=image dengan mengikuti setiap next_cursor. Baca GET /v1/media/assets/{asset_id} menggunakan setiap asset_id aktual untuk memperoleh content_url-nya; baca kembali aset yang sama jika tautan bertanda tangannya kedaluwarsa.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Mulai
CogView 4 adalah model teks ke gambar dari Zhipu, tersedia di Ailoot Ultra dengan ID persis cogview-4. Berikan deskripsi adegan untuk membuat ilustrasi, latar produk, atau konsep visual. Kontrol yang didokumentasikan mencakup ukuran gambar, kualitas standard atau hd, dan watermark_enabled; respons menyediakan URL gambar yang semuanya perlu disimpan.
- Masukan yang diterima
- Teks
- Hasil
- Gambar
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Images POST /v1/images/generations
- Masukan
text- Keluaran
image- Format keluaran
- Berkas gambar
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan cogview-4 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Bawaan1280x1280 |
Kolomuser_id | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan hd, standard | Bawaan— |
Kolomwatermark_enabled | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaantrue |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan false | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontraksize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Kontraktext |
Parameterconditions | KontrakUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiEstimated generation cost | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Masukan · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.09 estimasi sebelum pembuatan This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Terima dan simpan hasil
Ailoot Ultra · Images
Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jika respons asli perlu diperiksa
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias model
Ailoot Ultra cogview-4
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Zhipu: CogView 4
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·cogview-4:text→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream