API Seedance: Prompt và kịch bản qua một endpoint

Yêu cầu: Cài đặt SDK

Trước khi gửi yêu cầu đầu tiên, hãy đảm bảo bạn đã cài đặt SDK chính thức của OpenAI cho ngôn ngữ bạn muốn. API này sử dụng giao thức chat/completions tiêu chuẩn, nên mọi máy khách tương thích OpenAI đều hoạt động. Với Python, hãy cài gói qua pip. Với Node.js, hãy dùng npm. Bạn chỉ cần thư viện máy khách; không cần thêm phụ thuộc nào cho việc tạo văn bản cơ bản hoặc gọi hàm.

Xác thực: Đặt khóa API của bạn

Xác thực được xử lý qua mã token Bearer đơn giản. Tạo tài khoản trên trang Lấy khóa API để nhận khóa duy nhất của bạn. Không cần thẻ tín dụng cho bản dùng thử. Lưu khóa này vào biến môi trường hoặc tệp cấu hình ứng dụng. Khóa này cấp quyền truy cập vào mô hình không kiểm duyệt và liên kết với số dư tín dụng trả trước của bạn. Bạn có thể tạo lại khóa bất cứ lúc nào từ bảng điều khiển nếu cần.

Gửi yêu cầu hoàn thiện hội thoại

Thực hiện yêu cầu POST đến URL cơ sở. Trường model phải được đặt thành uncensored. Bao gồm prompt hệ thống để xác định vai trò và tin nhắn người dùng để tạo nội dung. Endpoint này xử lý hiệu quả các tác vụ viết kịch bản, tạo phụ đề và xử lý hậu kỳ văn bản.

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."}]
  }'

Phản hồi truyền phát cho đầu ra thời gian thực

Đối với kịch bản dài hoặc phụ đề thời gian thực, hãy bật truyền phát bằng cách đặt stream: true. API trả về luồng Sự kiện do máy chủ gửi (SSE) của các phần hoàn thiện từng phần. Điều này cho phép ứng dụng của bạn hiển thị văn bản khi nó được tạo, cải thiện độ trễ cảm nhận. Xử lý các chunk luồng trong SDK của bạn để cập nhật giao diện người dùng theo từng bước.

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)

Sử dụng gọi hàm cho dữ liệu có cấu trúc

API hỗ trợ gọi hàm để trích xuất dữ liệu có cấu trúc từ văn bản hoặc tạo đầu ra JSON. Xác định lược đồ công cụ của bạn trong yêu cầu. Mô hình sẽ trả về các đối số có cấu trúc mà mã của bạn có thể thực thi. Điều này rất lý tưởng cho các bước xử lý hậu kỳ khi bạn cần các trường cụ thể từ kịch bản hoặc siêu dữ liệu được tạo ra.

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)

Hiểu về giới hạn và hạn mức

Hãy chú ý đến các mã trạng thái HTTP tiêu chuẩn. Lỗi 401 có nghĩa là khóa API của bạn không hợp lệ hoặc đã hết hạn. Lỗi 402 cho biết không đủ tín dụng trả trước; hãy nạp tiền để tiếp tục. Lỗi 429 báo hiệu giới hạn tốc độ, giới hạn ở 300 yêu cầu mỗi phút mỗi khóa. Cửa sổ ngữ cảnh là 100,000 token tổng cộng. Các yêu cầu vượt quá 8 MB sẽ bị từ chối.

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);