Lompat ke konten

Playground v2.5 · Inpainting

Integrasikan

ID model playground-v25/inpainting
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Permintaan ini: ≈$0,004 4 kredit API · ≈ ₽0,43 Jalankan di halaman ini

Dapatkan kunci API
Playground Pengeditan Gambar #inpaint#artistic#style

Mengecat ulang area bertopeng pada gambar berdasarkan prompt, menggunakan gambar mask terpisah

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

Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.

•wajib image_url
Jatuhkan file, atau

Gambar awal untuk pembuatan, diberikan melalui URL.

•wajib mask_url
Jatuhkan file, atau

URL yang mengarah ke mask inpainting.

image_size bawaan square_hd

Dimensi gambar yang dihasilkan.

num_images bawaan 1

Jumlah gambar yang diminta untuk dibuat.

Lanjutan negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · embeddings
bawaan

Negative prompt yang menentukan detail gambar yang tidak diinginkan. Prompt ini dapat mengecualikan warna, objek, pemandangan, atau fitur dan kualitas yang lebih halus, seperti kumis, buram, atau resolusi rendah.

safety_checker_version bawaan v1

Pilih antara pemeriksa keamanan ViT khusus (`v2`) dan pemeriksa CompVis (`v1`, bawaan).

format bawaan jpeg

Format file untuk gambar hasil.

bawaan

Pengenal permintaan untuk menghubungkan respons dengan permintaan yang menghasilkannya.

bawaan 25

Jumlah langkah inferensi yang dijalankan.

bawaan 3

Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).

bawaan 0.95

Tingkat kemiripan antara gambar yang dihasilkan dan gambar awal.

Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.

bawaan []

Embedding yang dipilih untuk digunakan, diberikan sebagai daftar.

POST /run/playground-v25/inpainting?wait=20 estimasi harga → $0,004
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/playground-v25/inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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://api.doitong.ru/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 Playground v2.5 · Inpainting

Memerlukan `image_url`, `mask_url`, dan `prompt`, lalu membuat ulang area yang diberi mask. `strength` berkisar dari 0.01 hingga 1, langkah inferensi dari 1 hingga 65, dan `guidance_scale` dari 0 hingga 20. Hingga 8 output dapat diminta, dalam format jpeg atau png. `negative_prompt`, `seed`, embedding, dan nilai `image_size` prasetel juga didukung.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
Gambar awal untuk pembuatan, diberikan melalui URL.
mask_urlwajib mask
Tipeurl · image
URL yang mengarah ke mask inpainting.
promptwajib
Tipestring
Jelaskan gambar yang ingin dibuat sedetail mungkin untuk memperoleh hasil terbaik.
negative_promptopsional
Tipestring
Bawaan
Negative prompt yang menentukan detail gambar yang tidak diinginkan. Prompt ini dapat mengecualikan warna, objek, pemandangan, atau fitur dan kualitas yang lebih halus, seperti kumis, buram, atau resolusi rendah.
image_sizeopsional
Tipeobject
Bawaansquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi gambar yang dihasilkan.
num_inference_stepsopsional
Tipeinteger
Bawaan25
1 – 65
Jumlah langkah inferensi yang dijalankan.
guidance_scaleopsional
Tipenumber
Bawaan3
0 – 20
Kekuatan kepatuhan terhadap prompt untuk pemilihan gambar, dinyatakan sebagai CFG (Classifier Free Guidance).
strengthopsional
Tipenumber
Bawaan0.95
0,01 – 1
Tingkat kemiripan antara gambar yang dihasilkan dan gambar awal.
seedopsional
Tipeinteger | null
Seed untuk mereproduksi gambar dalam Stable Diffusion. Gambar dapat direproduksi secara persis pada setiap proses dengan mempertahankan versi model, prompt, dan seed.
num_imagesopsional num_outputs
Tipeinteger
Bawaan1
1 – 8
Jumlah gambar yang diminta untuk dibuat.
embeddingsopsional
Tipeobject[]
Bawaan[]
Embedding yang dipilih untuk digunakan, diberikan sebagai daftar.
embeddings[].pathwajib
Tipestring
Bobot embedding yang ditentukan melalui URL atau path file.
embeddings[].tokensopsional
Tipestring[]
Daftar token embedding, dengan penamaan otomatis jika dihilangkan: setiap vektor dalam file embedding menerima token dari urutan <s0>, <s1>, ... .
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Aktivasi pemeriksa keamanan; true mengaktifkan pemeriksaan.
safety_checker_versionopsional
Tipeenum
Bawaanv1
v1v2
Pilih antara pemeriksa keamanan ViT khusus (`v2`) dan pemeriksa CompVis (`v1`, bawaan).
expand_promptopsional
Tipeboolean
Bawaanfalse
Perluasan prompt dengan prompt tambahan, diaktifkan saat true.
formatopsional
Tipeenum
Bawaanjpeg
jpegpng
Format file untuk gambar hasil.
request_idopsional
Tipestring
Bawaan
Pengenal permintaan untuk menghubungkan respons dengan permintaan yang menghasilkannya.
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": "playground-v25/inpainting",
  "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": 4,
    "usd": "0.004",
    "charged": 4,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "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://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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, width, height, content_type}Informasi file untuk gambar yang dihasilkan.
timings
object
seed
integerSeed pembuatan gambar, termasuk nilai yang dipilih secara acak jika input tidak menyertakan seed; jika tidak, nilai yang diberikan akan diulang.
has_nsfw_concepts
array of booleanMenunjukkan apakah konsep NSFW muncul dalam gambar yang dihasilkan.
prompt
stringPrompt yang digunakan selama pembuatan gambar.

Model lainnya: Pengeditan Gambar

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/playground-v25/inpainting.md. Semua model dan panduan: https://doitong.com/developers/llms.txt