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

Xác thực & Base URL

API của chúng tôi sử dụng xác thực OpenAI tiêu chuẩn. Bạn chỉ cần một khóa API, mà bạn tạo trên trang Lấy khóa API. Không cần số điện thoại hoặc thẻ tín dụng để bắt đầu; mọi tài khoản mới đều nhận được $0,50 tín dụng dùng thử miễn phí có giá trị trong 7 ngày.

Đặt base URL là https://api.sunoapis.com/v1 trong cấu hình client của bạn. Định danh mô hình bạn phải gửi trong mọi yêu cầu là uncensored. Đây là mô hình trọng số mở được lưu trữ trên các máy chủ GPU riêng của chúng tôi, được tinh chỉnh cho nội dung người lớn hợp pháp và sáng tạo mà không có các từ chối thường thấy ở các nhà cung cấp lớn.

• Base URL: https://api.sunoapis.com/v1
• ID mô hình: uncensored
• Tiêu đề xác thực: Authorization: Bearer YOUR_API_KEY

Yêu cầu đầu tiên

Bắt đầu ngay lập tức với một yêu cầu hoàn thành cuộc trò chuyện tiêu chuẩn. Endpoint chấp nhận các tải trọng JSON chứa prompt hệ thống, hướng dẫn người dùng và bất kỳ metadata nào cần thiết cho quy trình văn bản sang video hoặc âm nhạc AI của bạn.

Đây là API chỉ xử lý văn bản. Nó không tạo ra audio, video hoặc hình ảnh; nó tạo ra các hướng dẫn văn bản điều khiển các công cụ đó. Sử dụng endpoint này để viết kịch bản cảnh, viết lời bài hát hoặc trích xuất dữ liệu có cấu trúc từ các tài sản sáng tạo của bạn.

Copycurl https://api.sunoapis.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."}]
  }'

SDK Python

Tích hợp API vào các ứng dụng Python của bạn bằng SDK OpenAI chính thức. Vì chúng tôi tương thích OpenAI, bạn có thể tái sử dụng mã hiện có bằng cách chỉ thay đổi base URL và khóa API.

Cách tiếp cận này hoạt động để tạo kịch bản cho các công cụ tạo video hoặc viết metadata cho các API âm nhạc. Đảm bảo phiên bản SDK của bạn được cập nhật để hỗ trợ các tính năng truyền phát và gọi hàm được mô tả trong các phần tiếp theo.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.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)

SDK Node.js

Đối với nhà phát triển JavaScript/TypeScript, gói @anthropic-ai/sdk hoặc gói chính thức openai đều hoạt động với các điều chỉnh cấu hình nhỏ. Hãy trỏ client của bạn đến base URL của chúng tôi và sử dụng định danh mô hình uncensored.

Điều này cho phép bạn xây dựng khả năng tạo văn bản phía máy chủ cho các ứng dụng sáng tạo của bạn. Bạn có thể sử dụng điều này để tiền xử lý đầu vào của người dùng hoặc hậu xử lý các kịch bản được tạo trước khi gửi chúng đến các endpoint tạo audio hoặc video của bạn. API trả về các phản hồi JSON tiêu chuẩn tương thích với các khung web hiện đại.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.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);

Phản hồi truyền phát

Đối với các kịch bản dài hoặc metadata chi tiết, hãy sử dụng Sự kiện gửi bởi máy chủ (SSE) để nhận token theo thời gian thực. Đặt stream: true trong thân yêu cầu của bạn. API sẽ gửi một chuỗi các chunk, cho phép bạn hiển thị văn bản khi nó được tạo.

Điều này đặc biệt hữu ích cho các công cụ sáng tạo tương tác nơi người dùng muốn xem prompt đang phát triển khi nó được viết. Mỗi chunk chỉ chứa văn bản delta, vì vậy bạn phải nối các mảnh lại để tái tạo phản hồi đầy đủ.

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)

Giới hạn, Lỗi & Ngữ cảnh

Mỗi tài khoản bị giới hạn một khóa API, có thể được tạo lại bất cứ lúc nào (thu hồi khóa cũ). Bạn được phép 300 yêu cầu mỗi phút mỗi khóa, với kích thước thân yêu cầu tối đa là 8 MB.

Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ, 402 nếu bạn không có đủ tín dụng trả trước, và 429 cho giới hạn tốc độ. Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra kết hợp.

Lưu ý về nội dung: Mô hình không từ chối các chủ đề gây tranh cãi hoặc người lớn, nhưng nó chặn nghiêm ngặt nội dung tình dục liên quan đến trẻ vị thành niên trong mọi yêu cầu.