Acestepパイプラインのクイックスタート

前提条件：APIキーの取得

リクエストを行う前に、有効なAPIキーが必要です。acestep.ccのAPIキーを取得ページにアクセスしてください。Googleで続行を使用して、またはメールアドレスとパスワードのアカウントを作成して登録できます。電話番号は必要ありません。登録すると、APIキーが即座に表示されます。このキーをコピーしてください。これを使用して、後続のすべてのリクエストを認証します。クレジットがない場合は、チャージする必要があります。$10から$500の金額に対して、USDT（TRC20）またはUSDC（Base）のみの暗号通貨決済を受け付けます。新しいアカウントには、カードなしで開始できる7日間有効な無料トライアルクレジット$0.50が付与されます。レート制限とトークン消費に対して使用状況を認証するため、キーを安全に保管してください。

インストール

APIは標準的なOpenAI互換プロトコルを使用します。お好みの言語の公式OpenAI SDK、または任意のHTTPクライアントを使用して対話できます。Pythonの場合はopenaiパッケージをインストールしてください。Node.jsの場合はopenaiをインストールしてください。カスタムベースURLをサポートするSDKの最新バージョンを使用していることを確認してください。当サービスのベースURLはhttps://api.acestep.cc/v1です。これにより、ベースURLとAPIキーを変更するだけで、OpenAIエンドポイントを想定した既存のパイプラインコードを再利用できます。リクエストで指定する必要があるモデルIDはuncensoredです。このモデルは、法的な成人向け、フィクション、または論争的なトピックに対する拒否を最小限に抑えるように調整されたオープンウェイトLLMであり、コンテンツフィルタが有効なクリエイティブ出力をブロックする可能性があるクリエイティブパイプラインに最適です。

基本リクエスト：テキストの生成

システムプロンプトとユーザーメッセージを/v1/chat/completionsにPOSTリクエストとして送信してください。モデルは生成されたテキストを返します。modelパラメータをuncensoredに設定してください。temperatureとtop_pで創造性を制御できます。コンテキストウィンドウは合計で最大100,000トークン（プロンプト＋補完）をサポートします。1リクエストあたりの最大出力は32,000トークンです。max_tokensを指定しない場合は2,048トークンです。エラーと拒否はクレジットを消費しませんが、成功したトークン生成は消費します。このエンドポイントは、スクリプトやキャプションの生成、または音声や画像生成APIなどの他のモーダリティに渡す前のテキストデータ処理に使用してください。

ストリーミングレスポンス

リアルタイムの更新には、リクエストでstream: trueを設定してください。APIはServer-Sent Events（SSE）を返します。各チャンクには部分的なテキストが含まれます。トークン使用の詳細は、ストリームの最終チャンクで提供されます。これは、生成されるテキストを表示するアプリケーションに有用で、ユーザーの体感レイテンシーを向上させます。クライアントがSSEを正しく処理することを確認してください。ストリームを使用すると、到着したトークンを処理できるため、パイプライン内の長文のコンテンツ生成に役立ちます。ストリーミングは価格やトークン制限を変更しないことを覚えておいてください。生成された総トークンに対して課金されます。

関数呼び出し

APIは関数呼び出しをサポートしており、定義されたツールに基づいてモデルが構造化データを出力できます。関数をtoolsパラメータに定義してください。tool_choiceをautoまたは特定の関数名に設定します。適切な場合、モデルは関数呼び出しオブジェクトを返します。これはテキストから構造化データを抽出したり、ダウンストリームAPI呼び出しの入力を準備したりする場合に有用です。response_formatを{"type": "json_object"}に設定することで、JSON出力を強制することもできます。これにより、モデルが有効なJSONを返すことが保証され、自動化されたパイプラインへの信頼性の高い統合に不可欠です。これらの機能を使用して、テキスト処理ステップの信頼性を向上させてください。

価格と制限

料金は、入力トークン1Mあたり$0.25、出力トークン1Mあたり$1.00です。クレジットは前払いで、期限切れになりません。エラーは無料です。レート制限は、キーあたり1分あたり300リクエスト、キーあたり同時に8リクエストです。最大のリクエストボディサイズは8 MBです。レート制限を超えると、429エラーが発生します。401エラーは、無効または期限切れのキーを示します。402エラーは、クレジットが不足していることを意味します。クレジットに対して返金は発行されません。紛争はサポートページを介して処理されます。アカウントあたり1つのアクティブなキーが許可されています。新しいキーを生成すると、古いキーが置き換えられます。パイプラインのリトライロジックを設計する際は、これらの制限を念頭に置いてください。

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

ストリーミング

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)