เริ่มต้นใช้งานอย่างรวดเร็ว
สร้างผลงานครั้งแรกของคุณได้ภายในไม่กี่นาที โมเดลทั้ง 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"
const res = await fetch("https://api.doitong.ru/v1/account", {
headers: { Authorization: `Bearer ${process.env.DOITONG_API_KEY}` },
});
console.log(await res.json());
import os
import requests
r = requests.get(
"https://api.doitong.ru/v1/account",
headers={"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}"},
)
print(r.json())
การสร้างผลงานจะหักจาก ยอดคงเหลือ 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}'
const res = await fetch("https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ image: "https://example.com/fox.jpg", duration: 5, generate_audio: true }),
});
const quote = await res.json();
console.log(quote.credits, quote.usd); // 840 "0.84"
import requests
r = requests.post(
"https://api.doitong.ru/v1/quote/kling-video/v3/pro/image-to-video",
json={"image": "https://example.com/fox.jpg", "duration": 5, "generate_audio": True},
)
print(r.json()["credits"], r.json()["usd"]) # 840 0.84
{
"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"}'
const res = await fetch("https://api.doitong.ru/v1/run/flux/schnell?wait=20", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DOITONG_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": "lighthouse-001",
},
body: JSON.stringify({ prompt: "A lighthouse on a rocky coast at dusk, warm light in the window" }),
});
const request = await res.json();
console.log(request.status, request.outputs[0]?.url);
import os
import requests
r = requests.post(
"https://api.doitong.ru/v1/run/flux/schnell",
params={"wait": 20},
headers={
"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}",
"Idempotency-Key": "lighthouse-001",
},
json={"prompt": "A lighthouse on a rocky coast at dusk, warm light in the window"},
)
request = r.json()
print(request["status"], request["outputs"][0]["url"] if request["outputs"] else None)
คำตอบคือออบเจ็กต์คำขอ:
{
"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 ปัจจุบัน
คำขอทุกคำจะผ่านวงจรเดียวกัน:
-
queuedยอมรับและเรียกเก็บเครดิตแล้ว กำลังรอผู้ประมวลผล -
runningโมเดลกำลังสร้างผลลัพธ์ -
สถานะสุดท้าย:
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"
const headers = { Authorization: `Bearer ${process.env.DOITONG_API_KEY}` };
let request = await (await fetch("https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t?wait=20", { headers })).json();
while (request.status === "queued" || request.status === "running") {
const res = await fetch(`https://api.doitong.ru/v1/requests/${request.id}?wait=20`, { headers });
request = await res.json();
}
console.log(request.status, request.outputs[0]?.url);
import os
import requests
headers = {"Authorization": f"Bearer {os.environ['DOITONG_API_KEY']}"}
request = {"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t", "status": "queued"}
while request["status"] in ("queued", "running"):
request = requests.get(
f"https://api.doitong.ru/v1/requests/{request['id']}",
params={"wait": 20},
headers=headers,
).json()
print(request["status"], request["outputs"][0]["url"] if request["outputs"] else None)
เมื่อ 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 เพื่อให้เอเจนต์แก้ไขคำขอได้โดยไม่ต้องอ่านข้อความ ไม่มีการเรียกเก็บเงินสำหรับคำขอที่ไม่ถูกต้อง
{
"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 mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
ขั้นตอนถัดไป
- เรียกดู โมเดลทั้งหมด แต่ละหน้ามีเครื่องมือสร้างคำขอที่เขียนโค้ดให้คุณ
- เรียนรู้วงจรของคำขอ: คำขอ
- ใช้ชื่อพารามิเตอร์เดียวกันกับทุกโมเดล: พารามิเตอร์
- กำลังทำงานร่วมกับเอเจนต์เขียนโค้ด AI อยู่ใช่ไหม มอบ https://doitong.com/developers/llms.txt ให้เอเจนต์ หรือเชื่อมต่อ เซิร์ฟเวอร์ MCP