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

Truy cập API bằng URL cơ bản https://api.sdxlapi.com/v1. Endpoint này tương thích hoàn toàn với các SDK và máy khách OpenAI tiêu chuẩn. Để xác thực, hãy chuyển khóa API của bạn trong tiêu đề Authorization của mọi yêu cầu.

Cách lấy khóa API: Đăng ký tại trang Lấy khóa API chỉ bằng email và mật khẩu. Khóa của bạn được hiển thị ngay lập tức. Không cần thẻ tín dụng cho bản dùng thử. Giữ khóa của bạn an toàn; bạn có thể tạo lại khóa bất cứ lúc nào, điều này sẽ làm vô hiệu hóa khóa cũ.

Gửi yêu cầu chat-completions tiêu chuẩn để tạo văn bản. ID mô hình là uncensored. Mô hình này được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp, khiến nó lý tưởng cho việc tạo prompt sáng tạo.

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

API chấp nhận payload JSON với mảng messages. API trả về chuỗi hoàn thành văn bản. Bạn có thể truyền prompt hệ thống để xác định nhân vật, chẳng hạn như một kỹ sư prompt chuyên nghiệp cho việc tạo ảnh.

Sử dụng gói Python openai chính thức. Định cấu hình máy khách bằng URL cơ bản và khóa API của bạn. Cách tiếp cận này hoạt động cho bất kỳ máy khách tương thích OpenAI nào.

Copyfrom openai import OpenAI

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

Phản hồi chứa văn bản được tạo trong response.choices[0].message.content. Bạn có thể phân tích đầu ra này trực tiếp vào quy trình của mình để tạo chú thích hoặc trích xuất siêu dữ liệu. SDK xử lý tự động việc tuần tự hóa JSON và chi tiết HTTP.

Đối với các dự án JavaScript hoặc TypeScript, hãy sử dụng gói npm openai. Đặt baseURL và apiKey trong đối tượng cấu hình. Điều này đảm bảo tương thích với các cơ sở mã OpenAI hiện có.

Copyimport OpenAI from "openai";

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

Cấu trúc phản hồi giống với định dạng OpenAI tiêu chuẩn. Bạn có thể truy cập văn bản được tạo thông qua response.data.choices[0].message.content. Điều này hữu ích cho việc tạo prompt phía máy chủ trước khi gửi ảnh đến một instance Stable Diffusion.

Hỗ trợ Sự kiện được gửi bởi máy chủ (SSE) cho phép bạn nhận token khi chúng được tạo. Điều này giảm độ trễ cảm nhận được đối với các kịch bản prompt dài hoặc mô tả chi tiết.

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)

Truyền phát phản hồi trong ứng dụng máy khách của bạn. Mỗi đoạn chứa một thông báo một phần. Tổng hợp các đoạn này để tái tạo văn bản cuối cùng. Điều này đặc biệt hữu ích cho bản xem trước theo thời gian thực của các prompt được tạo trong giao diện web.

Giới hạn tốc độ: 300 yêu cầu mỗi phút mỗi khóa. Kích thước thân: Tối đa 8 MB. Cửa sổ ngữ cảnh: Tổng cộng 100.000 token (đầu vào + đầu ra). Điều này cho phép các kịch bản dài hoặc kỹ thuật prompt mở rộng.

Lỗi phổ biến:

• 401 Unauthorized: Khóa API không hợp lệ hoặc bị thiếu.
• 402 Payment Required: Tín dụng trả trước không đủ.
• 429 Too Many Requests: Vượt quá giới hạn tốc độ.

Nếu bạn vượt quá giới hạn, hãy đợi một lát hoặc tạo lại khóa của bạn. Tất cả các yêu cầu chỉ là văn bản; không có ảnh, âm thanh hoặc video nào được tạo bởi API này.