Hướng dẫn nhanh cho quy trình Acestep

Điều kiện tiên quyết: Lấy khóa API của bạn

Trước khi thực hiện yêu cầu, bạn cần một khóa API hợp lệ. Truy cập trang Lấy khóa API trên acestep.cc. Bạn có thể đăng nhập bằng Đăng nhập bằng Google hoặc tạo tài khoản email và mật khẩu. Không cần số điện thoại. Sau khi đăng ký, khóa API của bạn sẽ được hiển thị ngay lập tức. Sao chép khóa này; bạn sẽ sử dụng nó để xác thực tất cả các yêu cầu tiếp theo. Nếu bạn không có tín dụng, bạn cần phải nạp tiền. Chúng tôi chỉ chấp nhận thanh toán bằng tiền điện tử (USDT trên TRC20 hoặc USDC trên Base) cho các khoản từ $10 đến $500. Tài khoản mới nhận được $0.50 tín dụng dùng thử có hiệu lực trong 7 ngày, không cần thẻ để bắt đầu. Hãy giữ khóa của bạn an toàn vì nó xác thực việc sử dụng của bạn đối với giới hạn tốc độ và mức tiêu thụ token.

Cài đặt

API sử dụng giao thức tương thích chính thức với OpenAI. Bạn có thể tương tác với nó bằng các SDK chính thức của OpenAI cho ngôn ngữ bạn chọn hoặc bất kỳ máy khách HTTP nào. Đối với Python, hãy cài đặt gói openai. Đối với Node.js, hãy cài đặt openai. Đảm bảo bạn đang sử dụng phiên bản SDK gần đây hỗ trợ URL cơ sở tùy chỉnh. URL cơ sở cho dịch vụ của chúng tôi là https://api.acestep.cc/v1. Điều này cho phép bạn tái sử dụng mã pipeline hiện có yêu cầu các endpoint của OpenAI, chỉ bằng cách thay đổi URL cơ sở và khóa API. ID mô hình bạn phải chỉ định trong các yêu cầu của mình là uncensored. Mô hình này là một LLM trọng số mở được tinh chỉnh để giảm thiểu việc từ chối các chủ đề người trưởng thành hợp pháp, hư cấu hoặc gây tranh cãi, khiến nó lý tưởng cho các pipeline sáng tạo nơi bộ lọc nội dung có thể chặn đầu ra sáng tạo hợp lệ.

Yêu cầu cơ bản: Tạo văn bản

Gửi yêu cầu POST đến /v1/chat/completions với prompt hệ thống và tin nhắn của người dùng. Mô hình sẽ trả về văn bản được tạo. Đảm bảo bạn đặt tham số model thành uncensored. Bạn có thể kiểm soát độ sáng tạo với temperature và top_p. Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token tổng cộng (prompt + completion). Đầu ra tối đa cho mỗi yêu cầu là 32.000 token, hoặc 2.048 nếu bạn không chỉ định max_tokens. Lỗi và từ chối không tiêu thụ tín dụng, nhưng việc tạo token thành công thì có. Sử dụng endpoint này để tạo kịch bản, chú thích hoặc xử lý dữ liệu văn bản trước khi chuyển nó sang các phương thức khác như API tạo giọng nói hoặc hình ảnh.

Truyền phát phản hồi

Để cập nhật theo thời gian thực, hãy đặt stream: true trong yêu cầu của bạn. API trả về các sự kiện do máy chủ gửi (SSE). Mỗi chunk chứa văn bản một phần. Chi tiết sử dụng token được cung cấp trong chunk cuối cùng của luồng. Điều này hữu ích cho các ứng dụng hiển thị văn bản khi nó được tạo, cải thiện độ trễ nhận thức cho người dùng. Đảm bảo máy khách của bạn xử lý SSE đúng cách. Luồng cho phép bạn xử lý token khi chúng đến, điều này có lợi cho việc tạo nội dung dài hạn trong pipeline của bạn. Hãy nhớ rằng việc truyền phát không thay đổi giá hoặc giới hạn token; bạn vẫn sẽ được tính phí cho tổng số token được tạo.

Gọi hàm

API hỗ trợ gọi hàm, cho phép mô hình xuất dữ liệu có cấu trúc dựa trên các công cụ do bạn xác định. Xác định các hàm của bạn trong tham số tools. Đặt tool_choice thành auto hoặc tên hàm cụ thể. Mô hình sẽ phản hồi bằng một đối tượng gọi hàm nếu phù hợp. Điều này rất có giá trị để trích xuất dữ liệu có cấu trúc từ văn bản hoặc chuẩn bị đầu vào cho các cuộc gọi API ở bước tiếp theo. Bạn cũng có thể buộc đầu ra JSON bằng cách đặt response_format thành {"type": "json_object"}. Điều này đảm bảo mô hình trả về JSON hợp lệ, điều rất quan trọng để tích hợp đáng tin cậy vào pipeline tự động hóa của bạn. Sử dụng các tính năng này để nâng cao độ tin cậy của các bước xử lý văn bản của bạn.

Giá cả và Giới hạn

Giá là $0,25 cho mỗi 1M token đầu vào và $1,00 cho mỗi 1M token đầu ra. Tín dụng là trả trước và không bao giờ hết hạn. Lỗi là miễn phí. Giới hạn tốc độ là 300 yêu cầu mỗi phút trên mỗi khóa và 8 yêu cầu đồng thời tại cùng một thời điểm trên mỗi khóa. Kích thước yêu cầu tối đa là 8 MB. Nếu bạn vượt quá giới hạn tốc độ, bạn sẽ nhận được lỗi 429. Lỗi 401 cho biết khóa không hợp lệ hoặc đã hết hạn. Lỗi 402 có nghĩa là bạn không có đủ tín dụng. Hoàn tiền không được cấp cho tín dụng; các tranh chấp được xử lý qua trang Hỗ trợ. Chỉ cho phép một khóa hoạt động trên mỗi tài khoản; tạo khóa mới sẽ thay thế khóa cũ. Hãy nhớ những giới hạn này khi thiết kế logic thử lại cho pipeline của bạn.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Truyền phá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)