მიმოხილვა და სწრაფი დაწყება

ავთენტიფიკაცია

ყოველი მოთხოვნა ავთენტიფიცირდება თქვენი API გასაღებით, როგორც Bearer ტოკენით. შექმენით გასაღები აპლიკაციაში პარამეტრებში, შემდეგ გააგზავნეთ იგი Authorization სათაურში:

Authorization: Bearer sk_...

გასაღები ჩნდება ერთხელ, შექმნისას. შეინახეთ ის საიდუმლოდ. ყოველი endpoint-ის საბაზისო URL არის https://sketchie.ai/api.

სწრაფი დაწყება

1. შექმენით ამხსნელი

გააგზავნეთ თქვენი თემა როგორც input და არასავალდებულო სამიზნე ხანგრძლივობა როგორც length (მოსახერხებელი "M:SS" სტრიქონი, როგორიცაა "0:30" ან "1:00", 30-წამიან ბიჯებში). გამოტოვეთ length ავტომატური ხანგრძლივობისთვის.

curl -X POST https://sketchie.ai/api/v1/explainer \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Explain how DNS resolves a domain name",
    "length": "0:30"
  }'

გამოძახება მაშინვე აბრუნებს 202 Accepted-ს რიგში მყოფ ჩანაწერთან ერთად. რენდერინგი მუშაობს ფონურ რეჟიმში და რამდენიმე წუთს იღებს.

{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "queued",
  "prompt": "Explain how DNS resolves a domain name",
  "lengthSeconds": 30,
  "voice": "sketchie:sulafat",
  "language": "en",
  "aspect": "16:9",
  "videoUrl": null,
  "sceneGraph": null
}

2. გამოკითხეთ შედეგი

მიიღეთ ამხსნელი id-ით, სანამ მისი status საბოლოო მდგომარეობას მიაღწევს. სასიცოცხლო ციკლია queued, შემდეგ generating, შემდეგ rendering, შემდეგ ready (მზადაა) ან failed.

curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
  -H "Authorization: Bearer sk_..."

როცა ის ready-ია, ჩანაწერი ატარებს ვიდეოს URL-ს და რედაქტირებად scene graph-ს:

{
  "id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
  "status": "ready",
  "videoUrl": "https://sketchie.ai/media/....mp4",
  "sceneGraph": { "scenes": [ ... ] }
}

სად წავიდეთ შემდეგ

• API მითითება . ყოველი endpoint, მისი მოთხოვნისა და პასუხის ფორმებით.
• ხმები . ნაგულისხმევი მთხრობელი, ექვსი ხმის კატალოგი და დასაკრავი წინასწარი ხედები.
• ენები . 34 მხარდაჭერილი თხრობის ენა.
• CLI და SDK . sketchie ბრძანების ხაზი და @sketchie/sdk TypeScript კლიენტი.
• MCP დაყენება . გამოიყენეთ Sketchie როგორც ხელსაწყოები Claude Desktop-ში, Claude Code-ში და Claude აპლიკაციაში.