canonical: https://jentic.com/apis/funtranslations.com/funtranslations-starwars

# Funtranslations Starwars Translations API

The FunTranslations Starwars Translations API converts English text into the fictional languages of the Star Wars universe - Yoda speak, Sith, Cheunh, Huttese, Mandalorian, and Gungan - through six dedicated GET endpoints. Each operation accepts a single text query parameter and returns the translated string inside a consistent JSON envelope alongside the source text. All endpoints authenticate with the X-Funtranslations-API-Secret header and share the FunTranslations subscription quota. The service targets fan apps, themed marketing experiences, and creative writing tools that want authentic Star Wars language flavour without building rule-based translators.

## For AI agents

Translate English text into six Star Wars languages - Yoda, Sith, Cheunh, Huttese, Mandalorian, and Gungan - through dedicated GET endpoints with a single text parameter.

## Scope

Does not handle real human languages, voice synthesis, or non-Star-Wars fictional languages - use for English-to-Star-Wars-language text translation only.

## Capabilities

- Translate English to Yoda's signature inverted-syntax speech via GET `/translate/yoda`
- Render English text as Sith dialect for villain-themed fan content
- Convert text into Cheunh, the Chiss language, for canonical Thrawn-era fan projects
- Translate English to Huttese phrases for Tatooine-themed apps and bots
- Produce Mandalorian translations including warrior idioms used by the Mandalorian clans
- Generate Gungan speech in the style of Jar Jar Binks for character voice apps

## Use cases

### Star Wars Fan Site Quote Generator

Add a quote translator to a Star Wars fan community by routing user input through GET `/translate/yoda` or GET `/translate/sith` and posting the result back into a forum thread or social card. The shared response shape lets the same client component swap between languages with one parameter change.

Example prompt: Call GET `/translate/yoda` with text='Master Obiwan has lost a planet.' and return the Yoda-speak translation.

### Themed Marketing Campaign Copy

Generate themed taglines for a Star Wars day promotion by passing campaign copy through GET `/translate/mandalorian` or GET `/translate/huttese` to produce on-brand alien-language variants. Marketers can A/B test the translated taglines without writing language rules in-house.

Example prompt: Call GET `/translate/mandalorian` with text="I'd like a pint of ale" and return the translated marketing tagline.

### Character Chatbot Voice Layer

Layer Star Wars character voice on top of an existing chatbot by sending the bot's English replies through GET `/translate/gungan` or GET `/translate/yoda` before rendering. A single text parameter and stable response shape keep latency low and the integration trivial.

Example prompt: Call GET `/translate/gungan` with text='Welcome to the server' and return the Gungan-styled greeting.

### Agent-Driven Star Wars Roleplay via Jentic

An AI agent powering an interactive Star Wars roleplay scene uses Jentic to find and call the right /translate endpoint based on the active character. When the user switches from a Jedi NPC to a Hutt crime lord, the agent searches Jentic for the relevant language and routes future replies through the matching operation.

Example prompt: Search Jentic for 'translate to huttese', load `/translate/huttese`, and execute it with the agent's next reply.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/translate/yoda` | Translate English to Yoda speak |
| GET | `/translate/sith` | Translate English to Sith |
| GET | `/translate/cheunh` | Translate English to Cheunh |
| GET | `/translate/huttese` | Translate English to Huttese |
| GET | `/translate/mandalorian` | Translate English to Mandalorian |
| GET | `/translate/gungan` | Translate English to Gungan |

## Key resources

- **Starwars** — Six GET endpoints under /translate covering Yoda, Sith, Cheunh, Huttese, Mandalorian, and Gungan languages.

## Why Jentic

- **Setup:** Wiring the Starwars Translations API by hand means setting up its secret-key request header auth against api.funtranslations.com and wiring each fictional-language endpoint yourself. Through Jentic you install once, import the Starwars Translations API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The text to translate travels as a request parameter, not a URL path resource, so scope this by operation: limit the agent to the operations it needs, such as a Yoda or Huttese translation, and leave the languages you do not want it calling out of the allowed set. Every operation the agent can run is one you chose to include.
- **Credential handling:** Your FunTranslations API secret is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'translate text to Yoda speak' or 'convert English to Sith', and Jentic returns the matching Starwars Translations API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **FunTranslations API** — Parent FunTranslations service exposing all 36 translators including the Star Wars set plus Morse, Braille, and dialects.
- **FunTranslations Braille API** — Sibling FunTranslations service for accessibility-oriented Braille output rather than fictional Star Wars languages.

## FAQ

### What authentication does the Starwars Translations API use?

All six endpoints require the X-Funtranslations-API-Secret request header. Jentic stores that key encrypted in its vault and injects it at execution, so the secret never reaches the agent's context.

### Can I translate text into Mandalorian with this API?

Yes. GET `/translate/mandalorian` accepts a text query parameter and returns the Mandalorian translation in the standard FunTranslations success envelope, with translation set to 'mandalorian'.

### What are the rate limits for the Starwars Translations API?

Quotas follow the FunTranslations subscription tiers documented at funtranslations.com/api/starwars; the free tier permits a small number of calls per hour, and paid tiers raise both hourly and daily caps. The OpenAPI spec does not pin specific numbers.

### How do I add a Yoda voice to an agent through Jentic?

Run a Jentic search for 'translate text to yoda speak', load GET `/translate/yoda`, and execute it with the text the agent wants restyled. Get started with Jentic One, the self-hosted execution layer.

### Does the API support reverse translation from Star Wars languages back to English?

No. Each of the six endpoints only translates from English into the target Star Wars language; reverse decoding is not provided.

### Can I limit what my agent is allowed to do with the Starwars Translations API?

Yes. Because you run Jentic One yourself, you decide which of the six translation operations the agent may call, so you can allow only GET `/translate/yoda` and GET `/translate/huttese` while leaving Sith, Cheunh, Mandalorian, and Gungan out of the allowed set. Since the text to translate travels as a request parameter rather than a URL path, scoping happens at the operation level: every language endpoint the agent can reach is one you chose to include. Your FunTranslations API secret is held by your own instance and injected only when a permitted operation runs, so the agent never sees the credential.