Langkau ke kandungan

FLUX.3 Klein

Integrasikan

ID model blackforestlabs/flux-3/klein/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fail seperti contoh: $0.009 9 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Black Forest Labs Teks ke Imej #image-generation#text-to-image#typography#graphic-design

Text-to-image dengan saiz 4K asli, kawalan susun atur kotak sempadan pilihan dan sehingga 4 imej bagi setiap permintaan

Black Forest Labs · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Arahan penjanaan imej yang menerangkan subjek, pembingkaian, pencahayaan dan latar belakang secara terperinci, sepadan dengan kapsyen terperinci yang digunakan untuk melatih model.

image_size lalai square_hd

Tetapkan lebar dan tinggi output secara berasingan dalam julat 256–4096 piksel, dengan sokongan penjanaan 4K asli.

num_images lalai 1

Bilangan imej yang diminta untuk penjanaan.

Lanjutan output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format lalai png

Format fail untuk imej yang terhasil.

Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.

Susun atur berkotak pilihan yang mengehadkan setiap objek yang diterangkan kepada kotak yang ditetapkan; kenal pasti kotak melalui label prompt, contohnya `A red fox <fox> sits under a red umbrella <umbrella>`. Koordinat menyatakan tepi kotak sebagai pecahan dimensi imej, diukur dari asal kiri atas (0, 0).

POST /run/blackforestlabs/flux-3/klein/text-to-image?wait=20 sebut harga → $0.009
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang FLUX.3 Klein

Menjana imej daripada `prompt` teks terperinci. Setiap sisi `image_size` boleh berjulat daripada 256 hingga 4096 piksel, dan anda boleh meminta 1 hingga 4 imej bagi setiap panggilan. Sehingga 32 `bounding_boxes` membolehkan anda meletakkan objek bernama pada kedudukan tertentu dalam bingkai. Output boleh berupa png, jpeg atau webp, dan pengembangan prompt boleh dihidupkan atau dimatikan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Arahan penjanaan imej yang menerangkan subjek, pembingkaian, pencahayaan dan latar belakang secara terperinci, sepadan dengan kapsyen terperinci yang digunakan untuk melatih model.
enable_prompt_expansionpilihan
Jenisboolean
Lalaitrue
Peluasan prompt menjadi kapsyen terperinci sebelum penjanaan, didayakan apabila true. Untuk penyuntingan, kapsyen berasaskan imej rujukan.
seedpilihan
Jenisinteger | null
Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 4
Bilangan imej yang diminta untuk penjanaan.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pengaktifan pemeriksa keselamatan; true mendayakan pemeriksaan.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail untuk imej yang terhasil.
image_sizepilihan
Jenisobject
Lalaisquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Tetapkan lebar dan tinggi output secara berasingan dalam julat 256–4096 piksel, dengan sokongan penjanaan 4K asli.
bounding_boxespilihan
Jenisobject[]
≤ 32 item
Susun atur berkotak pilihan yang mengehadkan setiap objek yang diterangkan kepada kotak yang ditetapkan; kenal pasti kotak melalui label prompt, contohnya `A red fox <fox> sits under a red umbrella <umbrella>`. Koordinat menyatakan tepi kotak sebagai pecahan dimensi imej, diukur dari asal kiri atas (0, 0).
bounding_boxes[].labelpilihan
Jenisstring | null
≤ 64 characters
Label objek ringkas untuk kotak, seperti `fox`; lalainya ialah `obj_<n>`. Sertakan `<fox>` dalam prompt untuk mengaitkan perkataannya dengan kotak; kotak yang tidak disebut dalam prompt ditambahkan ke dalam adegan.
bounding_boxes[].descriptiondiperlukan
Jenisstring
≤ 500 characters
Objek yang hendak dirender dalam kotak, termasuk rupanya.
bounding_boxes[].boxdiperlukan
Jenisobject
Peletakan objek dalam imej output.
bounding_boxes[].box.x_mindiperlukan
Jenisnumber
0 – 1
Sempadan kiri yang dinyatakan relatif kepada lebar imej, dari 0 hingga 1.
bounding_boxes[].box.y_mindiperlukan
Jenisnumber
0 – 1
Sempadan atas yang dinyatakan relatif kepada tinggi imej, dari 0 hingga 1.
bounding_boxes[].box.x_maxdiperlukan
Jenisnumber
0 – 1
Sempadan kanan yang dinyatakan relatif kepada lebar imej, dari 0 hingga 1.
bounding_boxes[].box.y_maxdiperlukan
Jenisnumber
0 – 1
Sempadan bawah yang dinyatakan relatif kepada tinggi imej, dari 0 hingga 1.
diperlukan Nama kanonik, turut diterima

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 9,
    "usd": "0.009",
    "charged": 9,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size, width, height}Imej yang dihasilkan oleh model.
timings
objectMaklumat masa untuk proses penjanaan.
seed
integerSeed penjanaan untuk imej pertama.
has_nsfw_concepts
array of booleanMenunjukkan sama ada konsep NSFW muncul dalam imej yang dijana.
prompt
stringPrompt yang digunakan semasa penjanaan imej.

Lebih banyak model: Teks ke Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/blackforestlabs/flux-3/klein/text-to-image.md. Semua model dan panduan: https://doitong.com/developers/llms.txt