ข้ามไปยังเนื้อหา

Playground v2.5 · Inpainting

ผสานการทำงาน

ID โมเดล 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"

คำขอนี้: ≈$0.004 4 เครดิต API · ≈ ₽0.43 เรียกใช้ในหน้านี้

รับคีย์ API
Playground แก้ไขภาพ #inpaint#artistic#style

วาดพื้นที่ที่มีมาสก์ของรูปภาพใหม่ตามพรอมต์ โดยใช้รูปภาพมาสก์แยกต่างหาก

Playground · ภาพ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น

อธิบายรูปภาพที่ต้องการสร้างโดยให้รายละเอียดมากที่สุดเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด

•จำเป็น image_url
วางไฟล์ หรือ

รูปภาพเริ่มต้นสำหรับการสร้าง ซึ่งส่งผ่าน URL

•จำเป็น mask_url
วางไฟล์ หรือ

URL ที่ชี้ไปยังมาสก์สำหรับการลงสีเติม

image_size ค่าเริ่มต้น square_hd

ขนาดของรูปภาพที่สร้างขึ้น

num_images ค่าเริ่มต้น 1

จำนวนรูปภาพที่ขอให้สร้าง

ขั้นสูง negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · embeddings
ค่าเริ่มต้น

พรอมต์เชิงลบที่ระบุรายละเอียดของรูปภาพที่ไม่ต้องการ สามารถตัดสี วัตถุ ทิวทัศน์ หรือคุณลักษณะและคุณภาพย่อยต่าง ๆ เช่น หนวด ความเบลอ หรือความละเอียดต่ำออกได้

safety_checker_version ค่าเริ่มต้น v1

เลือกระหว่างตัวตรวจสอบความปลอดภัย ViT แบบกำหนดเอง (`v2`) กับตัวตรวจสอบ CompVis (`v1` ซึ่งเป็นค่าเริ่มต้น)

format ค่าเริ่มต้น jpeg

รูปแบบไฟล์ของรูปภาพผลลัพธ์

ค่าเริ่มต้น

ตัวระบุคำขอสำหรับเชื่อมโยงการตอบกลับกับคำขอที่สร้างการตอบกลับนั้น

ค่าเริ่มต้น 25

จำนวนขั้นตอน inference ที่ต้องดำเนินการ

ค่าเริ่มต้น 3

ระดับการยึดตามพรอมต์สำหรับการเลือกรูปภาพ ซึ่งแสดงเป็น CFG (Classifier Free Guidance)

ค่าเริ่มต้น 0.95

ระดับความคล้ายระหว่างรูปภาพที่สร้างกับรูปภาพเริ่มต้น

Seed สำหรับสร้างรูปภาพซ้ำใน Stable Diffusion สามารถสร้างรูปภาพเดิมได้เหมือนกันทุกครั้งโดยคงเวอร์ชันโมเดล พรอมต์ และ seed เดิมไว้

ค่าเริ่มต้น []

Embedding ที่เลือกใช้ ซึ่งระบุเป็นรายการ

POST /run/playground-v25/inpainting?wait=20 ใบเสนอราคา → $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"

เรียกใช้คำขอนี้

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง Doitong API เท่านั้น และจะบันทึกใน localStorage ก็ต่อเมื่อคุณเลือกจดจำ รับคีย์ API

เกี่ยวกับ Playground v2.5 · Inpainting

ต้องมี `image_url`, `mask_url` และ `prompt` เพื่อสร้างพื้นที่ที่ถูกมาสก์ใหม่ `strength` อยู่ในช่วง 0.01 ถึง 1 ขั้นตอนการอนุมาน 1 ถึง 65 และ `guidance_scale` 0 ถึง 20 ขอเอาต์พุตได้สูงสุด 8 รายการในรูปแบบ jpeg หรือ png รองรับ `negative_prompt`, `seed`, เอ็มเบดดิง และค่า `image_size` ที่ตั้งไว้ล่วงหน้าด้วย

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
image_urlจำเป็น image
ประเภทurl · image
รูปภาพเริ่มต้นสำหรับการสร้าง ซึ่งส่งผ่าน URL
mask_urlจำเป็น mask
ประเภทurl · image
URL ที่ชี้ไปยังมาสก์สำหรับการลงสีเติม
promptจำเป็น
ประเภทstring
อธิบายรูปภาพที่ต้องการสร้างโดยให้รายละเอียดมากที่สุดเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด
negative_promptไม่บังคับ
ประเภทstring
ค่าเริ่มต้น
พรอมต์เชิงลบที่ระบุรายละเอียดของรูปภาพที่ไม่ต้องการ สามารถตัดสี วัตถุ ทิวทัศน์ หรือคุณลักษณะและคุณภาพย่อยต่าง ๆ เช่น หนวด ความเบลอ หรือความละเอียดต่ำออกได้
image_sizeไม่บังคับ
ประเภทobject
ค่าเริ่มต้นsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ขนาดของรูปภาพที่สร้างขึ้น
num_inference_stepsไม่บังคับ
ประเภทinteger
ค่าเริ่มต้น25
1 – 65
จำนวนขั้นตอน inference ที่ต้องดำเนินการ
guidance_scaleไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น3
0 – 20
ระดับการยึดตามพรอมต์สำหรับการเลือกรูปภาพ ซึ่งแสดงเป็น CFG (Classifier Free Guidance)
strengthไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น0.95
0.01 – 1
ระดับความคล้ายระหว่างรูปภาพที่สร้างกับรูปภาพเริ่มต้น
seedไม่บังคับ
ประเภทinteger | null
Seed สำหรับสร้างรูปภาพซ้ำใน Stable Diffusion สามารถสร้างรูปภาพเดิมได้เหมือนกันทุกครั้งโดยคงเวอร์ชันโมเดล พรอมต์ และ seed เดิมไว้
num_imagesไม่บังคับ num_outputs
ประเภทinteger
ค่าเริ่มต้น1
1 – 8
จำนวนรูปภาพที่ขอให้สร้าง
embeddingsไม่บังคับ
ประเภทobject[]
ค่าเริ่มต้น[]
Embedding ที่เลือกใช้ ซึ่งระบุเป็นรายการ
embeddings[].pathจำเป็น
ประเภทstring
น้ำหนัก embedding ที่ระบุด้วย URL หรือพาธไฟล์
embeddings[].tokensไม่บังคับ
ประเภทstring[]
รายการโทเค็น embedding หากไม่ระบุ ระบบจะตั้งชื่ออัตโนมัติ: เวกเตอร์แต่ละรายการในไฟล์ embedding จะได้รับโทเค็นจากลำดับ <s0>, <s1>, ...
enable_safety_checkerไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
การเปิดใช้ตัวตรวจสอบความปลอดภัย; true จะเปิดใช้การตรวจสอบ
safety_checker_versionไม่บังคับ
ประเภทenum
ค่าเริ่มต้นv1
v1v2
เลือกระหว่างตัวตรวจสอบความปลอดภัย ViT แบบกำหนดเอง (`v2`) กับตัวตรวจสอบ CompVis (`v1` ซึ่งเป็นค่าเริ่มต้น)
expand_promptไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
การขยายพรอมต์ด้วยพรอมต์เพิ่มเติม ซึ่งเปิดใช้งานเมื่อเป็น true
formatไม่บังคับ
ประเภทenum
ค่าเริ่มต้นjpeg
jpegpng
รูปแบบไฟล์ของรูปภาพผลลัพธ์
request_idไม่บังคับ
ประเภทstring
ค่าเริ่มต้น
ตัวระบุคำขอสำหรับเชื่อมโยงการตอบกลับกับคำขอที่สร้างการตอบกลับนั้น
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

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"
  }
}
ไฟล์ของคุณ คุณเลือกเองทุก outputs[].url คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง
ฟิลด์ของเอาต์พุต
images
array of object {url, width, height, content_type}ข้อมูลไฟล์สำหรับรูปภาพที่สร้าง
timings
object
seed
integerseed สำหรับการสร้างรูปภาพ รวมถึงค่าที่สุ่มเลือกหากอินพุตไม่ได้ระบุ seed มิฉะนั้นจะใช้ค่าที่ระบุซ้ำ
has_nsfw_concepts
array of booleanระบุว่ามีแนวคิด NSFW ปรากฏในรูปภาพที่สร้างหรือไม่
prompt
stringพรอมต์ที่ใช้ระหว่างการสร้างรูปภาพ

โมเดลเพิ่มเติม: แก้ไขภาพ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/playground-v25/inpainting.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt