ข้ามไปยังเนื้อหา
เริ่มต้นใช้งาน

เริ่มต้นใช้งานอย่างรวดเร็ว

ดูเป็น Markdown อัปเดตแล้ว

สร้างผลงานครั้งแรกของคุณได้ภายในไม่กี่นาที โมเดลทั้ง 1,496 โมเดลรับคำขอประเภทเดียวกันและส่งคืนออบเจ็กต์คำขอเดียวกัน สำหรับรูปภาพ วิดีโอ และเสียง: เรียนรู้ครั้งเดียวได้ที่นี่

1. รับคีย์ API

สร้างคีย์ที่ https://doitong.com/developers/dashboard#keys และเก็บไว้ในตัวแปรสภาพแวดล้อม: คีย์จะแสดงเพียงครั้งเดียว แต่ละคีย์กำหนดงบประมาณของตัวเองได้ คุณจึงมอบคีย์ให้เอเจนต์ได้โดยไม่เสี่ยงกับทั้งบัญชี GET /account จะแสดงยอดคงเหลือ API ของคุณ

export DOITONG_API_KEY="doitong_..."

curl "https://api.doitong.ru/v1/account" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

การสร้างผลงานจะหักจาก ยอดคงเหลือ API ของบัญชีคุณในรูปเครดิต API: 1,000 เครดิต API = $1 และแต่ละโมเดลมีค่าใช้จ่ายตรงตามราคาของผู้สร้าง เติมเงินที่ https://doitong.ru/developers/dashboard#balance

2. ขอราคา แล้วจึงเริ่มทำงาน

POST /quote/{model_id} รับ JSON อินพุตและส่งคืนราคาที่แน่นอน ไม่ต้องใช้คีย์และไม่มีค่าใช้จ่าย การใช้อินพุตเดียวกันจะมีค่าใช้จ่ายตามราคานั้นพอดี: ราคาที่เสนอคือค่าบริการ ข้อยกเว้นคือโมเดลที่คิดค่าบริการตามการใช้งาน: ราคาที่เสนอคือราคาสูงสุดที่การทำงานอาจมีค่าใช้จ่าย และส่วนที่ไม่ได้ใช้จะได้รับการคืนเงินหลังการทำงานเสร็จสิ้น

curl -X POST "https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://example.com/fox.jpg", "duration": 5, "generate_audio": true}'
200 OK · ราคา
{
  "object": "quote",
  "model": "kling-video/v3/pro/image-to-video",
  "credits": 840,
  "usd": "0.84",
  "unit": "second",
  "quantity": 5,
  "unit_credits": 168,
  "mode": "exact",
  "breakdown": "5 s × 168 API credits"
}

จากนั้นส่ง body เดิมไปยัง POST /run/{model_id} เพิ่ม ?wait=20 เพื่อคงการเชื่อมต่อไว้นานสูงสุด 20 วินาที: โมเดลที่ทำงานเร็ว จะส่งคืนผลลัพธ์ที่เสร็จแล้วภายในการรับส่งข้อมูลครั้งเดียว ส่งเฮดเดอร์ Idempotency-Key เพื่อให้การลองใหม่ไม่ทำงานซ้ำ (หรือเรียกเก็บเงินซ้ำ)

curl -X POST "https://api.doitong.ru/v1/run/flux/schnell?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-001" \
  -d '{"prompt": "A lighthouse on a rocky coast at dusk, warm light in the window"}'

คำตอบคือออบเจ็กต์คำขอ:

200 OK · คำขอ
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux/schnell",
  "status": "succeeded",
  "cost": { "credits": 3, "usd": "0.003", "charged": 3, "refunded": 0 },
  "outputs": [
    { "type": "image", "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg", "width": 1024, "height": 768, "stored": true }
  ],
  "error": null
}

3. ติดตามสถานะ

หากโมเดลยังทำงานอยู่เมื่อหมดเวลารอ คุณจะได้รับ 202 Accepted พร้อม id ของคำขอและ status ปัจจุบัน คำขอทุกคำจะผ่านวงจรเดียวกัน:

วงจรการทำงานของคำขอ
  1. queued ยอมรับและเรียกเก็บเครดิตแล้ว กำลังรอผู้ประมวลผล
  2. running โมเดลกำลังสร้างผลลัพธ์
  3. สถานะสุดท้าย:
    • succeededเรียกเก็บเงินตามราคาที่เสนอ; outputs[] มี URL บนพื้นที่จัดเก็บของเรา
    • failedคืนเครดิตโดยอัตโนมัติ ข้อผิดพลาดจะระบุสาเหตุ
    • canceledหยุดก่อนมีผลลัพธ์ คืนเครดิตแล้ว

อ่านคำขออีกครั้งด้วย id ของคำขอ ?wait=20 ใช้ที่นี่ได้เช่นกัน ดังนั้นวนลูปอย่างง่ายก็เพียงพอ:

curl "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

เมื่อ status เป็น succeeded, outputs[].url จะเก็บลิงก์ไปยังไฟล์ในพื้นที่จัดเก็บของเรา หากคำขอ failed หรือ canceled, เครดิต API จะได้รับการคืนเงินโดยอัตโนมัติ และ error จะระบุสาเหตุ ยกเลิกสิ่งที่ยังอยู่ในสถานะ queued หรือ running:

เทอร์มินัล
curl -X POST "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

สำหรับงานวิดีโอที่ใช้เวลานาน คุณสามารถข้ามการตรวจสอบสถานะและส่ง webhook_url แทนได้ (ดู เว็บฮุก)

4. ไฟล์

ส่ง URL สาธารณะใดก็ได้เป็นอินพุต หรือขอ URL สำหรับอัปโหลดจาก POST /files, ใช้ PUT กับไฟล์นั้น และใช้ file_url ที่ส่งคืน (ดู ไฟล์) คำขอที่สำเร็จจะแสดงผลลัพธ์ใน outputs[] พร้อม type, content type และเมื่อทราบข้อมูล จะแสดงขนาดและระยะเวลา

เทอร์มินัล
curl -X POST "https://api.doitong.ru/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "fox.jpg", "content_type": "image/jpeg", "size": 482113}'

ข้อผิดพลาด

โมเดลทุกตัวรายงานข้อผิดพลาดในรูปแบบเดียวกัน: envelope หนึ่งชุดที่มี type, code ที่ตรงตามจริง, param ที่ก่อให้เกิดปัญหา และปัญหาทั้งหมดใน details เพื่อให้เอเจนต์แก้ไขคำขอได้โดยไม่ต้องอ่านข้อความ ไม่มีการเรียกเก็บเงินสำหรับคำขอที่ไม่ถูกต้อง

422 Unprocessable Entity
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_input",
    "message": "duration must be one of 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.",
    "param": "duration",
    "details": [ { "param": "duration", "message": "duration must be one of 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15." } ],
    "request_id": null,
    "doc_url": "https://doitong.com/developers/docs/errors#invalid_input"
  }
}

ดูรายการ type และ code ทั้งหมดได้ที่ ข้อผิดพลาด

ราคา

ราคาแสดงเป็น USD และเครดิต API และจะแสดงในหน้าโมเดลทุกหน้าก่อนเริ่มทำงาน คำขอแต่ละรายการมี cost ซึ่งประกอบด้วย credits, usd, charged และ refunded การทำงานจะถูกเรียกเก็บเงินเมื่อได้รับการยอมรับ คำขอที่ failed และ canceled จะได้รับการคืนเงินโดยอัตโนมัติ โมเดลบางตัวคิดราคาตรงจากอินพุต บางตัวคิดตามความยาวหรือขนาดของไฟล์ที่คุณส่ง และบางตัวคิด ราคาประเมินต่อการทำงาน: ไม่ว่าแบบใด ราคาที่เสนอคือราคาที่คุณจ่าย โมเดลบางตัว (โมเดลภาษาและการมองเห็น เครื่องมือเสียง และเครื่องมือประมวลผลตามเวลา) คิดค่าบริการตามการใช้งาน: ราคาที่เสนอคือราคาสูงสุดที่การทำงานอาจมีค่าใช้จ่าย และส่วนที่การทำงาน ไม่ได้ใช้จะได้รับการคืนเงินโดยอัตโนมัติ ดู ราคา

MCP และเอเจนต์ AI

เชื่อมต่อไคลเอ็นต์ MCP ใดก็ได้กับ https://api.doitong.ru/v1/mcp โดยใช้คีย์ Bearer เดียวกัน เอเจนต์ของคุณสามารถค้นหาแค็ตตาล็อก เสนอราคาและ สั่งให้โมเดลทำงาน และอ่านหน้าเอกสารทุกหน้าในรูปแบบ Markdown

Claude Code
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

ขั้นตอนถัดไป