Languages

How do you build Spanish AI apps with Plugsky?

Spanish works on Plugsky with the usual one-line change: base_url to https://api.plugsky.com/v1, then send UTF-8 text to /v1/chat/completions. Keep accents and inverted punctuation, pin one address form and regional vocabulary, and use plugsky-embed-multilingual so Spain and Latin American variants share an embedding collection with English.

Key facts

Spanish textLatin script with ñ, accents and inverted punctuation ¿ ¡
Locale variantsSpain and Latin America differ in vocabulary and address forms
TokenisationLong verb forms and accented text can split — measure with the Plugsky token calculator
API compatibilityOpenAI-compatible POST https://api.plugsky.com/v1/chat/completions — chat, streaming, JSON mode and function calling
Models30+ models behind one endpoint, from free tiers to frontier reasoning
Free tierFree plan with plugsky-micro and plugsky-lite, no card required
DeploymentPlugsky cloud, your VPC, on-prem and air-gapped options
Product statusChat, streaming, JSON mode, function calling, embeddings, RAG and agents live; audio, images, batch and fine-tuning coming soon

TL;DR

  • Spanish runs on the standard OpenAI-compatible endpoint.
  • Keep accents and the ¿ ¡ marks — they are not optional.
  • Pin tú, vos or usted per market.
  • Track es-ES and LatAm vocabulary as separate eval slices.
  • plugsky-embed-multilingual covers Spanish and English retrieval.

How it works, step by step

  1. Create a Plugsky API key on the free plan (no card) and set base_url to https://api.plugsky.com/v1.
  2. Send a small set of real Spanish prompts to /v1/chat/completions and compare output across two or three models.
  3. Count tokens for those prompts with the Plugsky token calculator and set chunk sizes that fit your model context.
  4. Normalise text before indexing or prompting: NFC-normalise accents and pick one regional vocabulary.
  5. For RAG, embed with plugsky-embed-multilingual and test cross-language queries alongside Spanish-only queries.
  6. Score candidate models on a Spanish gold set with native-speaker review, then cut production traffic over.
1Create a PlugskyAPI key on the freeplan (no card) and2Send a small set ofreal Spanishprompts to3Count tokens forthose prompts withthe Plugsky token4Normalise textbefore indexing orprompting:5For RAG, embed withplugsky-embed-multilingualand test6Score candidatemodels on a Spanishgold set with

Try it yourself

Open the OpenAI cost calculator →

How Plugsky handles Spanish text

Spanish uses the Latin alphabet with ñ and accents, and opens questions and exclamations with inverted marks (¿ and ¡).

Spain and Latin America differ in vocabulary, and address forms tú, vos and usted vary by country and formality.

Evaluate on Spain and Latin American samples; check accent marks, agreement and address forms, which automated metrics tend to miss.

Tokenisation and cost in Spanish

Spanish is close to English on token cost; accented vowels and inverted punctuation are handled reliably by modern tokenisers, but long verb forms and regional vocabulary affect counts modestly.

  • Keep inverted punctuation and accents — they carry meaning.
  • Pick one address form per surface and country.
  • Maintain a Spain versus Latin America vocabulary glossary.
  • Measure tokens on your real content, not translated samples.

Spanish retrieval and RAG

One multilingual collection can serve Spanish documents and English queries, but evaluate Spain and Latin American vocabulary variants separately for retrieval precision.

  • Use plugsky-embed-multilingual for Spanish and English corpora.
  • NFC-normalise accents before embedding.
  • Track es-ES and es-419 queries separately.
  • Add regional synonyms to keyword search.

Code example: a Spanish request

Point your existing OpenAI client at https://api.plugsky.com/v1 and pass Spanish text in the content field — no language flag and no separate endpoint. Streaming, JSON mode and function calling keep the same request shapes.

client = OpenAI(base_url="https://api.plugsky.com/v1", api_key=os.environ["PLUGSKY_API_KEY"])

client.chat.completions.create(model="plugsky-pro", messages=[{"role": "user", "content": "Resume este contrato en tres puntos, en español."}])

Start on the free plan with plugsky-micro and plugsky-lite, then compare paid models on a Spanish gold set before cutover. See the docs for request details.

For production, log the model name and your normalisation settings with each request, and re-run the Spanish gold set whenever either changes — language quality regressions usually come from prompt or preprocessing drift, not from the model alone.

Honest comparison

CapabilityPlugskySpanish workflow todayBuilding in-house
API compatibilityOpenAI-compatible — change base_url and model nameVaries by provider and SDKFull rewrite
Spanish text handlingOne regional vocabulary with ¿ ¡ and accents preservedDepends on provider tokeniser and prompt hygieneYou build normalisation, segmentation and evals
Token budgetFixed tokeniser per model; measure with the Plugsky token calculator and chunk to fitVaries by provider and modelYou host and tune each tokeniser
Multilingual retrievalplugsky-embed-multilingual available for cross-language RAGOften needs a separate embedding vendorYou serve and maintain embeddings
SovereigntyCloud, VPC, on-prem and air-gapped with residency optionsUsually US/EU public endpointsYou own the full stack

Frequently asked questions

Can Plugsky handle Spanish text?

Yes. The API accepts UTF-8 Spanish input on the OpenAI-compatible chat endpoint; output quality depends on the model, so compare two or three on your own prompts before choosing.

How do I estimate token usage for Spanish?

Spanish is close to English on token cost; accented vowels and inverted punctuation are handled reliably by modern tokenisers, but long verb forms and regional vocabulary affect counts modestly. Use the token calculator at /tools/llm-token-calculator before sizing context windows or chunk lengths.

Which Spanish variant should I target?

Choose Spain or Latin America per market and keep vocabulary consistent; neutral es-419 works for multi-country launches but reads flat in local markets.

Tú, vos or usted?

Decide per country and product surface. Usted for formal services, tú for most consumer apps, vos for Argentina, Uruguay and parts of Central America.

Is there a multilingual embedding model?

Yes — plugsky-embed-multilingual is part of the 30+ model catalogue and is built for cross-language retrieval. Keep one embedding model per vector collection.

Can I keep data in my region?

Plugsky supports cloud, VPC, on-prem and air-gapped deployment with data-residency options; confirm your requirements with the docs and the enterprise team.

How do I migrate an existing app?

Change base_url to https://api.plugsky.com/v1 and map the model name. Streaming, JSON mode, function calling and embeddings keep the same request shapes.

Is there a free plan?

Yes — the free plan includes two free models, plugsky-micro and plugsky-lite, with no card. A 14-day full-access trial unlocks the paid catalogue.