Snelstart voor Acestep-pipelines

Vereisten: Haal je API-sleutel op

Voordat je verzoeken doet, heb je een geldige API-sleutel nodig. Bezoek de API-sleutel ophalen pagina op acestep.cc. Je kunt je aanmelden via Doorgaan met Google of door een account aan te maken met e-mail en wachtwoord. Er is geen telefoonnummer nodig. Na registratie wordt je API-sleutel direct weergegeven. Kopieer deze sleutel; je gebruikt hem om alle daaropvolgende verzoeken te verifiëren. Als je geen tegoed hebt, moet je opwaarderen. We accepteren alleen cryptobetalingen (USDT op TRC20 of USDC op Base) voor bedragen tussen $10 en $500. Nieuwe accounts ontvangen $0,50 aan proeftegoed dat 7 dagen geldig is, zonder dat een creditcard nodig is om te beginnen. Bewaar je sleutel veilig, omdat deze je gebruik verifieert tegen de rate limits en tokenconsumptie.

Installatie

De API gebruikt het standaard OpenAI-compatible protocol. Je kunt ermee werken via de officiële OpenAI SDK's voor je voorkeurstaal of elke HTTP-client. Voor Python installeer je het openai pakket. Voor Node.js installeer je openai. Zorg dat je een recente versie van de SDK gebruikt die aangepaste basis-URLs ondersteunt. De basis-URL voor onze service is https://api.acestep.cc/v1. Hiermee kun je bestaande pipeline-code hergebruiken die OpenAI-endpoints verwacht, door simpelweg de basis-URL en API-sleutel te vervangen. De model-ID die je in je verzoeken moet opgeven, is uncensored. Dit model is een open-weight LLM die is afgestemd op minimale weigeringen voor wettelijke, volwassen, fictieve of controversiële onderwerpen, wat het ideaal maakt voor creatieve pipelines waar inhoudsfilters geldige creatieve output anders zouden blokkeren.

Basisverzoek: Tekst genereren

Stuur een POST-verzoek naar /v1/chat/completions met je systeem-prompt en gebruikersberichten. Het model retourneert gegenereerde tekst. Zorg dat je de parameter model instelt op uncensored. Je kunt de creativiteit regelen met temperature en top_p. Het contextvenster ondersteunt in totaal maximaal 100.000 tokens (prompt + voltooiing). De maximale uitvoer per verzoek is 32.000 tokens, of 2.048 als je max_tokens niet opgeeft. Fouten en weigeringen verbruiken geen tegoed, maar succesvolle tokengeneratie wel. Gebruik dit endpoint voor het genereren van scripts, bijschriften of het verwerken van tekstgegevens voordat je deze doorgeeft aan andere modaliteiten zoals speech- of afbeeldingsgeneratie-API's.

Streaming responsen

Stel voor realtime-updates stream: true in je verzoek in. De API retourneert Server-Sent Events (SSE). Elke chunk bevat gedeeltelijke tekst. Gegevens over tokenverbruik worden verstrekt in de laatste chunk van de stream. Dit is nuttig voor applicaties die tekst weergeven terwijl deze wordt gegenereerd, wat de waargenomen latentie voor gebruikers verbetert. Zorg dat je client SSE correct verwerkt. De stream stelt je in staat tokens te verwerken zodra ze binnenkomen, wat voordelig is voor het genereren van lange inhoud in jouw pipeline. Onthoud dat streaming de prijzen of tokenlimieten niet verandert; je wordt nog steeds gefactureerd voor het totale aantal gegenereerde tokens.

Function calling

De API ondersteunt function calling, waardoor het model gestructureerde gegevens kan uitvoeren op basis van jouw gedefinieerde tools. Definieer je functies in de parameter tools. Stel tool_choice in op auto of een specifieke functienaam. Het model reageert met een functie-aanroepobject als dat gepast is. Dit is waardevol voor het extraheren van gestructureerde gegevens uit tekst of het voorbereiden van invoer voor downstream API-aanroepen. Je kunt ook JSON-uitvoer afdwingen door response_format in te stellen op {"type": "json_object"}. Dit zorgt ervoor dat het model geldige JSON retourneert, wat cruciaal is voor betrouwbare integratie in jouw geautomatiseerde pipeline. Gebruik deze functies om de betrouwbaarheid van je tekstverwerkingsstappen te verbeteren.

Prijzen en limieten

Prijzen zijn $0,25 per 1M inputtokens en $1,00 per 1M outputtokens. Tegoed is prepaid en verloopt nooit. Fouten zijn gratis. Rate limits zijn 300 verzoeken per minuut per sleutel en 8 gelijktijdige verzoeken tegelijk per sleutel. De maximale grootte van de request body is 8 MB. Als je de rate limit overschrijdt, ontvang je een 429-fout. Een 401-fout geeft een ongeldige of verlopen sleutel aan. Een 402-fout betekent dat je onvoldoende tegoed hebt. Teruggaven voor tegoed worden niet uitgegeven; geschillen worden afgehandeld via de Support-pagina. Er is één actieve sleutel toegestaan per account; het genereren van een nieuwe sleutel vervangt de oude. Houd deze limieten in gedachten bij het ontwerpen van de retry-logica van jouw pipeline.

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

Streaming

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)