Embedding API
OpenAI tekstembeddings voor semantische zoekopdrachten, retrieval, clustering en rankingworkflows.
# Base URL
https://runapi.ai
# Endpoints
POST /v1/embeddings
curl https://runapi.ai/v1/chat/completions \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-ada-002",
"input": [
"Maak embeddings van deze supportartikelen en een klantvraag zodat ik de dichtstbijzijnde matches kan rangschikken."
],
"encoding_format": "float"
}'from openai import OpenAI
client = OpenAI(
base_url="https://runapi.ai/v1",
api_key="your-runapi-key"
)
response = client.chat.completions.create(
model="text-embedding-ada-002",
messages=[{"role": "user", "content": "Maak embeddings van deze supportartikelen en een klantvraag zodat ik de dichtstbijzijnde matches kan rangschikken."}]
)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://runapi.ai/v1",
apiKey: "your-runapi-key"
});
const response = await client.chat.completions.create({
model: "text-embedding-ada-002",
messages: [{ role: "user", content: "Maak embeddings van deze supportartikelen en een klantvraag zodat ik de dichtstbijzijnde matches kan rangschikken." }]
});OpenAI Embedding-modellen zetten tekst om in dense vectoren voor semantische zoekopdrachten, retrieval-augmented generation, clustering, classificatie en ranking. De text-embedding-3-familie ondersteunt efficiente productieretrieval met optionele controle over vectordimensionaliteit.
- Meerdere varianten voor verschillende snelheid-/kwaliteitsniveaus
- Modelskill bevat docs, schema's en setupnotities
- Werkt met appgerichte codeerworkflows
- Mislukte generaties worden niet in rekening gebracht
Vergelijk alle API-varianten
| Variant | Billing | From | |
|---|---|---|---|
| text-embedding-3-large | 1K tokens | $0.010 | Bekijken → |
| text-embedding-3-small | 1K tokens | $0.010 | Bekijken → |
| text-embedding-ada-002 | 1K tokens | $0.010 | Bekijken → |
Embedding API-endpoints
Gebruik de OpenAI- of Anthropic-SDK met je RunAPI-sleutel. Geen extra SDK nodig.
| Endpoint | Protocol |
|---|---|
| /v1/embeddings | OpenAI Embeddings |
Van modelskill naar eerste resultaat in vier stappen
Kies het model
Kies het model en de variant die passen bij je outputtype, kwaliteitslat en latencydoel.
Configureren
Stel je RunAPI-key in en installeer de modelskill in je codeworkspace.
Bouwen
Gebruik de skill-instructies om de modelfeature in je applicatie toe te voegen.
Ontvangen
Poll op task-ID, stream wanneer ondersteund of verwerk de webhook-callback.
Wat is de Embedding API?
OpenAI Embedding-modellen bieden de standaard OpenAI Embeddings API via RunAPI, zodat vector search- en RAG-pipelines dezelfde RunAPI-sleutel kunnen gebruiken als GPT chat- en Responses-verkeer.
Waarom de Embedding API via RunAPI gebruiken
Eén auth, elke provider
Met één RunAPI-sleutel ontgrendel je de hele catalogus. Geen aparte accounts, geen sleutelrotatie per integratie.
Uniforme prijzen & billing
Prijs per call in USD, maandelijks gefactureerd. Mislukte generaties worden niet in rekening gebracht.
Skill met schema's
Getypeerde schema's en setupnotities zitten in de modelskill, zodat implementatie start vanuit het juiste contract.
Veelgestelde vragen
Welk embeddingmodel moet ik gebruiken?
Gebruik text-embedding-3-small voor efficiente productieretrieval en text-embedding-3-large wanneer recallkwaliteit belangrijker is dan vectorgrootte.
Kan ik de embeddingvector verkorten?
Ja. Geef de parameter dimensions mee met text-embedding-3-large of text-embedding-3-small wanneer je kleinere vectoren nodig hebt.
Geeft het endpoint de standaard OpenAI responsevorm terug?
Ja. /v1/embeddings retourneert een OpenAI-compatibele list response met embeddingdata, model en usage.
Kunnen embeddingmodellen worden gebruikt met Chat Completions of Responses?
Nee. Embeddingmodellen zijn alleen beschikbaar op /v1/embeddings.
Welke inputs worden ondersteund?
Gebruik een string, een array van strings of tokenarrays volgens het OpenAI Embeddings API-formaat.
Met welke variant moet ik beginnen?
Kies de goedkoopste variant die aan je kwaliteitsnorm voldoet. De meeste teams beginnen met de snelle variant en stappen over op pro voor productie.
Is er een gratis tier?
Nieuwe accounts krijgen de eerste calls gratis op elk model. Daarna betaal je per call.
Streamen jullie resultaten?
Waar streaming beschikbaar is, streamt RunAPI end-to-end.
Hoe worden mislukkingen gefactureerd?
Mislukte generations worden niet in rekening gebracht.
Worden outputs gecachet?
Gegenereerde outputs worden opgeslagen en zijn op te vragen via task-ID. Inputs worden niet gecachet.
Mag ik het commercieel gebruiken?
Ja — commercieel gebruik is inbegrepen voor elke variant, tenzij een modellicentie het expliciet beperkt. Dat staat aangegeven op de variantpagina.
Hoe zit het met rate limits?
Rate limits per key schalen mee met je usage tier. Zie de prijzenpagina voor de actuele limieten.
Waar kan ik problemen melden?
Open een issue in de publieke GitHub-repo of mail support.