Lompat ke konten

Hunyuan Image · v3 · Instruct · Edit

Integrasikan

ID model hunyuan-image/v3/instruct/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan-image/v3/instruct/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

Permintaan ini: ≈$0,174 174 kredit API Jalankan di halaman ini

Dapatkan kunci API
Tencent Pengeditan Gambar #tencent#hunyuan-image#instruct#edit

Pengeditan gambar berbasis instruksi dari hingga 3 gambar referensi, dengan perluasan prompt opsional

Tencent · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Instruksi teks yang digunakan untuk membuat gambar.

•wajib image_urls
Jatuhkan file, atau

Berikan referensi pembuatan melalui URL, dengan maksimal 3 gambar dalam daftar.

image_size bawaan auto

Dimensi gambar output, baik diminta secara eksplisit maupun dipilih oleh model saat diatur ke auto.

num_images bawaan 1

Jumlah gambar yang diminta untuk dibuat.

Lanjutan output_format · guidance_scale · seed · enable_prompt_expansion · enable_safety_checker
output_format bawaan png

Format file untuk gambar hasil.

bawaan 3.5

Kekuatan mengikuti prompt: naikkan nilai ini agar model mengikuti prompt dengan lebih ketat.

Seed untuk reproduktibilitas; None memungkinkan sistem memilihnya secara acak alih-alih menggunakan nilai yang ditentukan pemanggil.

POST /run/hunyuan-image/v3/instruct/edit?wait=20 estimasi harga → $0,174
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan-image/v3/instruct/edit?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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Hunyuan Image · v3 · Instruct · Edit

Mengedit gambar mengikuti teks `prompt`, menggunakan satu hingga tiga gambar referensi dalam `image_urls`. `image_size` defaultnya auto sehingga model memilih ukuran output. Hingga 4 gambar dapat dikembalikan, `guidance_scale` berkisar dari 1 hingga 20, dan perluasan prompt aktif secara default. Output berupa png atau jpeg.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
Instruksi teks yang digunakan untuk membuat gambar.
image_sizeopsional
Tipeobject
Bawaanauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi gambar output, baik diminta secara eksplisit maupun dipilih oleh model saat diatur ke auto.
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 4
Jumlah gambar yang diminta untuk dibuat.
guidance_scaleopsional
Tipenumber
Bawaan3.5
≤ 20> 1
Kekuatan mengikuti prompt: naikkan nilai ini agar model mengikuti prompt dengan lebih ketat.
enable_prompt_expansionopsional
Tipeboolean
Bawaantrue
Ekspansi prompt melalui recaptioning oleh model internal, diaktifkan saat diatur ke true.
seedopsional
Tipeinteger | null
Seed untuk reproduktibilitas; None memungkinkan sistem memilihnya secara acak alih-alih menggunakan nilai yang ditentukan pemanggil.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Aktivasi pemeriksa keamanan; true mengaktifkan pemeriksaan.
output_formatopsional
Tipeenum
Bawaanpng
jpegpng
Format file untuk gambar hasil.
image_urlswajib images
Tipeurl[] · image
Berikan referensi pembuatan melalui URL, dengan maksimal 3 gambar dalam daftar.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-image/v3/instruct/edit",
  "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": 174,
    "usd": "0.174",
    "charged": 174,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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
      }
    ],
    "seed": 42
  },
  "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of object {url, content_type, file_name, file_size, width, height}Daftar yang berisi gambar yang dibuat.
seed
integerSeed dasar yang digunakan selama pembuatan.

Model lainnya: Pengeditan Gambar

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/hunyuan-image/v3/instruct/edit.md. Semua model dan panduan: https://doitong.com/developers/llms.txt