Recraft: Recraft V4 Styles Pro

Recraft V4 Styles Pro menghasilkan gambar raster 2K dalam gaya visual yang ditetapkan referensi. Model dirancang untuk aset kampanye terperinci dan kumpulan gambar dengan tekstur, rendering, palet, serta tampilan keseluruhan tetap konsisten saat subjek berubah.

Ailoot Ultra · Gambar POST /v1/images/generations recraft/recraft-v4-styles-pro

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Recraft V4 Styles Pro adalah model raster beresolusi lebih tinggi dalam keluarga khusus V4 Styles Recraft. Model membuat gambar baru dari brief teks dan gaya visual yang diberikan melalui gambar referensi atau gaya tersimpan. Model ditujukan untuk kampanye, ilustrasi merek, dan kumpulan gambar lain dengan rendering, tekstur, serta karakter komposisi perlu terbawa dari satu aset ke aset berikutnya. Model terpisah dari Recraft V4 Pro dan V4.1 Pro, yang masukan gayanya opsional, bukan persyaratan penentu model.

Styles Pro menghasilkan keluaran raster 2K, dengan format WebP lossless atau PNG. Keluaran persegi dalam tabel ukuran produsen adalah 2048 × 2048 piksel, sementara keluaran 16:9 adalah 2688 × 1536; rasio lain yang didukung memiliki dimensi masing-masing. Keluaran Pro yang lebih besar dapat berguna untuk visual kampanye terperinci dan tata letak lebih besar. Varian vektor justru menghasilkan SVG dan tidak memiliki ukuran piksel tetap, sehingga edisi Pro raster ini tidak seharusnya dipilih ketika hasil kerja yang dimaksud berupa berkas vektor yang dapat diedit.

Setiap generasi dalam keluarga Styles memerlukan gaya. Berikan satu hingga sepuluh gambar referensi PNG, JPG, atau WebP, atau gunakan ulang gaya tersimpan kompatibel; pengenal gaya dan referensi baru adalah masukan alternatif, bukan pasangan yang digabungkan. Alur produsen mengizinkan hingga 64 MB di seluruh referensi, dengan setiap berkas di bawah 20 MB. Pembuatan gaya tidak memerlukan tahap pelatihan yang dijalankan pengguna. Satu referensi jelas dapat menetapkan arah padu, dan beberapa referensi membantu ketika sudah berbagi bahasa visual yang sama, alih-alih tampilan bersaing. Setiap referensi harus memiliki sisi terpendek minimal 256 piksel, sisi terpanjang maksimal 4.096 piksel, dan resolusi total maksimal 16 megapiksel.

Pencocokan gaya fleksibel merupakan bawaan dan mengizinkan penafsiran referensi lebih longgar. Pencocokan presisi mengikuti rendering, palet, komposisi, serta pencahayaan lebih dekat. Referensi menetapkan bahasa visual; brief teks tetap harus menjelaskan subjek, aksi, adegan, dan pembingkaian baru. Untuk kampanye produk terperinci, tentukan botol kaca di permukaan batu pucat, pandangan tiga perempat, cahaya samping lembut, dan ruang jelas bagi judul, sementara referensi yang diberikan membawa pengolahan fotografis.

Model menerima prompt hingga 10.000 karakter, mendukung warna pilihan serta warna latar yang diinginkan, dan dapat menggunakan seed acak. Alur generasi terdokumentasi dapat mengembalikan satu hingga enam gambar. Kendali bergunanya berbeda dari edisi Recraft lama: nama gaya kurasi, negative_prompt, dan text_layout tidak didukung, dan keluarga Styles tidak menyediakan gambar ke gambar atau inpainting. Referensi adalah sumber gaya, bukan mask atau instruksi mempertahankan foto yang sudah ada piksel demi piksel.

Siapkan aset referensi bersih dengan detail cukup dan gunakan ulang gaya yang sama ketika mengembangkan kumpulan. Jika keluaran menjadi berulang, ubah subjek, pose, sudut kamera, atau adegan dalam brief teks, alih-alih menambahkan referensi tidak berkaitan. Kecocokan warna tepat antara referensi dan keluaran tidak dijamin; kendali warna pilihan menyatakan arah, bukan hasil pemeriksaan warna. Untuk aset kampanye akhir, nilai gambar pada ukuran tampilan atau cetak yang dimaksud dan periksa apakah subjek, ruang kosong berguna, serta pengolahan visual cocok dengan brief.

Ailoot Ultra · Gambar POST /v1/images/generations recraft/recraft-v4-styles-pro

recraft/recraft-v4-styles-pro

Recraft /recraft/recraft-v4-styles-pro

Mulai

Masukan yang diterima: Teks · Gambar
Hasil: Gambar

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Gambar POST /v1/images/generations

Masukan: text, image
Keluaran: image

Kolom	Jenis	Persyaratan	Nilai & batasan	Bawaan
Kolom`model`	Jenis`string`	PersyaratanWajib	Nilai & batasan recraft/recraft-v4-styles-pro	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanWajib	Nilai & batasan Panjang minimum: 1	Bawaan—
Kolom`aspect_ratio`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto	Bawaan—
Kolom`n`	Jenis`integer`	PersyaratanOpsional	Nilai & batasan Minimum: 1 Maksimum: 6	Bawaan—
Kolom`input_references`	Jenis`array`	PersyaratanOpsional	Nilai & batasan Item minimum: 1 Item maksimum: 10	Bawaan—
Kolom`provider`	Jenis`object`	PersyaratanOpsional	Nilai & batasan	Bawaan—

Parameter metode dan siklus hidup

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt
Parameter`material_types`	Kontraktext, image

Siklus hidup: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media

GET /v1/media/assets/{asset_id}/content

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	Satuan penagihan	Kondisi penagihan	Biaya
KonfigurasiTarif dasar token	Jadwal tarifTarif dasar	Jumlah perkiraan—	Satuan penagihan—	Kondisi penagihan—	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
KonfigurasiReferensi masukan	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper permintaan	Kondisi penagihanPembuatan gaya saat menggunakan referensi gaya; sekali per permintaan, ditambahkan pada harga gambar keluaran.	Biaya Masukan · Referensi masukan · Perkiraan hanya untuk perbandingan $0.01 per permintaan
Konfigurasigambar keluaran	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper gambar keluaran	Kondisi penagihan—	Biaya Keluaran · gambar keluaran · Perkiraan hanya untuk perbandingan $0.2 per gambar keluaran
KonfigurasiPerkiraan biaya pembuatan	Jadwal tarif—	Jumlah perkiraanestimasi satu kali pembuatan	Satuan penagihan—	Kondisi penagihan—	Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.2 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

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 · Gambar

curl

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={'model': 'recraft/recraft-v4-styles-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

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
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Terima dan simpan hasil

Ailoot Ultra · Gambar

Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Pembacaan konten lain

Baca aset yang sudah ada dan menjadi milik Anda

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Simpan semua hasil yang selesai

Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.

Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.

Jika respons asli perlu diperiksa

Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.

Kolom respons

Kolom	Jenis
Kolom`created`	Jenis
Kolom`data[].url`	Jenis
Kolom`data[].b64_json`	Jenis
Kolom`usage`	Jenis

Alias

Alias model

Ailoot Ultra recraft/recraft-v4-styles-pro

Alias jalur metode

/v1/images

ID pemanggil terkait

recraft/recraft-v4-styles-pro

FAQ · Recraft: Recraft V4 Styles Pro

Input dan hasil apa yang tersedia?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: text, image → image
Kolom apa yang digunakan permintaan?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: model, prompt, aspect_ratio, n, input_references, provider
Batasan apa yang berlaku?: POST /v1/images/generations · recraft/recraft-v4-styles-pro: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4 Styles Pro