API ของ Seedance: พรอมต์และสคริปต์ผ่านเอนด์พอยต์เดียว

ข้อกำหนดเบื้องต้น: ติดตั้ง SDK

ก่อนส่งคำขอครั้งแรก ให้ตรวจสอบว่าคุณได้ติดตั้ง OpenAI SDK สำหรับภาษาที่คุณต้องการแล้ว API นี้ใช้โปรโตคอล chat/completions มาตรฐาน ดังนั้นไคลเอนต์ที่เข้ากันได้กับ OpenAI จึงใช้งานได้ สำหรับ Python ให้ติดตั้งแพ็กเกจผ่าน pip สำหรับ Node.js ให้ใช้ npm คุณต้องการเพียงไลบรารีไคลเอนต์เท่านั้น ไม่ต้องการการพึ่งพาเพิ่มเติมสำหรับการสร้างข้อความหรือการเรียกใช้ฟังก์ชันพื้นฐาน

การตรวจสอบสิทธิ์: การตั้งค่าคีย์ API ของคุณ

การตรวจสอบสิทธิ์ดำเนินการผ่านโทเคน Bearer แบบง่าย สร้างบัญชีที่หน้า รับคีย์ API เพื่อรับคีย์เฉพาะของคุณ ไม่จำเป็นต้องใช้บัตรเครดิตสำหรับการทดลองใช้ เก็บคีย์นี้ในตัวแปรสภาพแวดล้อมหรือไฟล์กำหนดค่าแอปพลิเคชันของคุณ คีย์นี้ให้สิทธิ์เข้าถึงโมเดลแบบไม่เซ็นเซอร์และผูกติดกับยอดเครดิตแบบเติมเงินล่วงหน้าของคุณ สามารถสร้างคีย์ใหม่ได้ทุกเมื่อจากแดชบอร์ดของคุณหากจำเป็น

การส่งคำขอ Chat Completion

ส่งคำขอ POST ไปยัง URL พื้นฐาน ฟิลด์ model ต้องตั้งค่าเป็น uncensored รวมพรอมต์ระบบของคุณเพื่อกำหนดบทบาท และข้อความผู้ใช้สำหรับการสร้างเนื้อหา เอนด์พอยต์นี้จัดการงานเขียนสคริปต์ การเขียนคำบรรยาย และงานประมวลผลข้อความหลังการเขียนได้อย่างมีประสิทธิภาพ

Copycurl https://api.seedanceapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

การตอบกลับแบบสตรีมมิงสำหรับผลลัพธ์แบบเรียลไทม์

สำหรับสคริปต์ยาวหรือการเขียนคำบรรยายแบบเรียลไทม์ ให้เปิดใช้งานสตรีมมิงโดยตั้งค่า stream: true API จะส่งคืนสตรีม Server-Sent Events (SSE) ของการตอบกลับบางส่วน การอนุญาตนี้ทำให้แอปพลิเคชันของคุณแสดงข้อความขณะที่กำลังสร้างอยู่ ซึ่งช่วยปรับปรุงความล่าช้าที่รับรู้ จัดการส่วนสตรีมใน SDK ของคุณเพื่ออัปเดต UI แบบเพิ่มทีละน้อย

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

การใช้การเรียกใช้ฟังก์ชันสำหรับข้อมูลที่มีโครงสร้าง

API รองรับฟังก์ชันการเรียกใช้เพื่อดึงข้อมูลที่มีโครงสร้างจากข้อความหรือสร้างผลลัพธ์ JSON กำหนดสคีมาเครื่องมือของคุณในคำขอ โมเดลจะตอบกลับด้วยอาร์กิวเมนต์ที่มีโครงสร้างที่โค้ดของคุณสามารถดำเนินการได้ สิ่งนี้มีประโยชน์อย่างยิ่งสำหรับขั้นตอนการประมวลผลหลังการผลิตเมื่อคุณต้องการฟิลด์เฉพาะจากสคริปต์ที่สร้างหรือเมตาดาต้า

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.seedanceapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

ทำความเข้าใจขีดจำกัดและโควตา

ระวังรหัสสถานะ HTTP มาตรฐาน ข้อผิดพลาด 401 หมายความว่าคีย์ API ของคุณไม่ถูกต้องหรือหมดอายุ ข้อผิดพลาด 402 บ่งชี้ว่าเครดิตแบบเติมเงินล่วงหน้าไม่เพียงพอ ให้เติมเงินเพื่อดำเนินการต่อ ข้อผิดพลาด 429 บ่งชี้ถึงขีดจำกัดอัตรา ซึ่งจำกัดไว้ที่ 300 คำขอต่อนาทีต่อคีย์ หน้าต่างบริบทมีขนาด 100,000 โทเคนรวม คำขอที่เกิน 8 MB จะถูกปฏิเสธ

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.seedanceapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);