Recraft: Recraft V4.1

Recraft V4.1 membuat gambar raster 1K dengan fotorealisme alami, ilustrasi ekspresif, dan komposisi disengaja. Model dapat mengembangkan arahan kreatif singkat atau mengikuti brief terperinci, dengan masukan gambar serta gaya khusus opsional.

Ailoot Ultra · Gambar POST /v1/images/generations recraft/recraft-v4.1

Tentang model

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

Recraft V4.1 adalah model raster utama dalam keluarga V4.1 Recraft. Model dibuat untuk kreasi gambar ekspresif, termasuk foto tampak alami, ilustrasi, dan konsep visual berdimensi. Produsen menyajikannya sebagai model yang dapat menyediakan keputusan estetika dari prompt singkat sekaligus menanggapi arahan kreatif lebih terperinci. Gunakan untuk eksplorasi, pengembangan konsep, dan gambar dengan suasana, pencahayaan, serta komposisi menjadi bagian hasil, alih-alih disederhanakan menjadi pandangan produk menghadap depan.

Kode produsen yang tepat adalah recraftv4_1. Model mengembalikan gambar raster 1K dalam WebP lossless atau PNG, dengan keluaran persegi 1024 × 1024 piksel dan 16:9 sebesar 1344 × 768. Rasio lain yang didukung menggunakan dimensinya sendiri. V4.1 Pro adalah edisi raster 2K terpisah, Vector mengembalikan SVG yang dapat diedit, dan Utility mengutamakan pencahayaan serta adegan lebih sederhana. Cabang tersebut melayani hasil kerja berbeda dan tidak boleh digabung menjadi satu kumpulan sifat keluaran.

Produsen menyoroti adegan fotografis lebih alami, latar lebih tenang, gradasi lebih halus, dan jangkauan ilustrasi luas. Contohnya mencakup huruf ekspresif, ilustrasi karakter datar, dan lembar referensi karakter yang digambar. Prompt singkat dapat menyisakan ruang bagi penafsiran model; brief terperinci dapat menetapkan subjek, pose, material, latar, dan komposisi. Untuk visual berdimensi, tentukan pengolahan permukaan serta pencahayaan, sambil mengingat bahwa hasilnya gambar, bukan mesh atau proyek 3D yang dapat diedit.

Untuk konsep ruang baca, minta foto intim sudut baca kecil, cahaya siang hangat, buku, dan satu objek keramik, dengan susunan santai alih-alih seperti ruang pamer. Brief ilustrasi terkendali dapat menyebut subjek grafis, hubungan warna, dan pengolahan garis. Nyatakan rasio aspek yang dimaksud serta keputusan visual terpenting. Hal ini memudahkan penentuan apakah detail tidak terduga merupakan penafsiran kreatif berguna atau sesuatu yang harus berubah dalam brief berikutnya.

Referensi generasi mengizinkan prompt hingga 10.000 karakter, seed acak, warna pilihan, dan warna latar yang diinginkan, dengan satu hingga enam keluaran. Gambar referensi opsional atau gaya tersimpan kompatibel dapat menetapkan bahasa visual dengan pencocokan fleksibel atau presisi. Keduanya tidak diwajibkan bagi edisi V4.1 utama. Pilih referensi bersih yang selaras satu sama lain dan gunakan prompt untuk konten baru; reproduksi warna referensi tidak dijamin. Untuk generasi bergaya referensi, gunakan satu hingga sepuluh gambar PNG, JPG, atau WebP, total tidak lebih dari 64 MB dan masing-masing di bawah 20 MB. Setiap referensi memerlukan sisi terpendek minimal 256 piksel, sisi terpanjang maksimal 4.096 piksel, dan resolusi maksimal 16 megapiksel. Gunakan referensi ini atau gaya tersimpan kompatibel, bukan keduanya.

V4.1 juga mendukung alur gambar ke gambar terpisah dengan gambar yang sudah ada, teks, dan strength 0 hingga 1. Operasi menggunakan strength untuk mengendalikan kedekatan gambar baru dengan sumber dan tidak menerima kendali gaya khusus V4.1. Referensi generasi model saat ini mengecualikan negative_prompt, gaya kurasi, text_layout, artistic_level, dan no_text. Jelaskan adegan yang dimaksud secara langsung dan periksa aset hasil dalam tata letak sasaran, termasuk detail, potongan, dan hurufnya, sebelum menentukan arah visual yang dipertahankan. Untuk gambar ke gambar, berikan PNG, JPG, WebP, atau SVG di bawah 20 MB, maksimal 16 megapiksel, dengan kedua sisi antara 256 dan 4.096 piksel.

Ailoot Ultra · Gambar POST /v1/images/generations recraft/recraft-v4.1

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

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.1	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanWajib	Nilai & batasan Panjang minimum: 1	Bawaan—
Kolom`aspect_ratio`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1:1, 4:3, 3:4, 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: 0 Item maksimum: 1	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	Biaya
KonfigurasiTarif dasar token	Jadwal tarifTarif dasar	Jumlah perkiraan—	Satuan 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
Konfigurasigambar keluaran	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper gambar keluaran	Biaya Keluaran · gambar keluaran · Perkiraan hanya untuk perbandingan $0.07 per gambar keluaran
KonfigurasiPerkiraan biaya pembuatan	Jadwal tarif—	Jumlah perkiraanestimasi satu kali pembuatan	Satuan penagihan—	Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.07 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.1', '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.1

Alias jalur metode

/v1/images

ID pemanggil terkait

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

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

Recraft: Recraft V4.1