---
title: "Rask API v3 quickstart: API keys, spending limits and your first dub"
description: Create a Rask API v3 key, choose its access and monthly spending limits, estimate the price and dub your first video with curl. Model selection, your own SRT, rate limits and error codes.
image: https://cdn.prod.website-files.com/63ab2ba4785d7f058efab318/6ae9c8448cd2ba14048ef407_rask-og-video-localization.jpg
---

[Skip to content](https://help.rask.ai/hc/rask-api-v3-quickstart#main-content)

English

Show submenu for translations

[Customer portal](https://member.rask.ai/tickets?hsLang=en)

![White\_favicon.png\]](https://help.rask.ai/hs-fs/hubfs/White_favicon.png?height=40&name=White_favicon.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Customer portal](https://member.rask.ai/tickets)
- [Go to RASK AI](https://www.rask.ai/)

[Go to RASK AI](https://www.rask.ai/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Rask AI Help Center](https://help.rask.ai/hc?hsLang=en)
2. [Features](https://help.rask.ai/hc/features?hsLang=en)

November 19, 2026

# Rask API v3 quickstart: API keys, spending limits and your first dub

## Create an API key, set its spending limits and dub your first video through Rask API v3 in six steps.

Rask API v3 connects video localization to your own product, CMS or content pipeline. With recurring volume, the API removes manual uploads and handoffs: your system sends a video and receives the dubbed file, the subtitles and the status of every job.

- **Base URL:** `https://api.rask.ai/v3`
- **Authentication:** an API key in the `Authorization: Bearer` header
- **Operations:** 82, covering uploads and imports, projects, transcripts, voices and voice clones, dubbing, lip-sync, on-screen text translation, exports, usage and balance
- **SDKs:** Python, TypeScript, Go, Java and PHP ([Rask API SDKs](https://help.rask.ai/hc/python-sdk-for-rask-api?hsLang=en))
- **Plans:** Creator, Creator Pro, Business and Enterprise. The free trial does not include API access.
- **Full reference:** [docs.api.rask.ai](https://docs.api.rask.ai)

Every operation that spends minutes has a **free estimate**. The real request carries the approved price as a cap, so a request never costs more than you approved.

### **Step 1. Create an API key**

1. In the Rask app, open **Settings → API keys**.
2. Click **Create API key**.
3. Choose the access level:

| Access | What the key can do |
| --- | --- |
| **Read-only** | Read projects, transcripts, jobs, usage and balance. |
| **Full access** | Create and change projects. Spending is **off** by default: such a key is shown as **Full access, no spending**. |
| **Full access** + **Allow spending credits** | Everything above, plus dubbing, lip-sync and other paid actions within the monthly limits you set. |
| **Custom** | Choose individual permissions. |

1. If you allow spending, set the **monthly limits**. The form suggests 120 minutes and 10 project credits per calendar month (UTC). You can change them within the limits set by the Teamspace owner.
2. Choose the expiry: **In 30 days**, **In 90 days**, **In 1 year** (default) or **Never**. **Never** is available only for keys that cannot spend.
3. Copy the key and store it in a secret manager.

Each key belongs to **one Teamspace**. Give each team or integration its own key, so you can revoke one without affecting the others.

### **Step 2. Check the key**

```
export RASK_API_KEY="your_key"

curl https://api.rask.ai/v3/me \
  -H "Authorization: Bearer $RASK_API_KEY"
```

The response shows the key, the user and the Teamspace. `GET /v3/plan` returns your plan, its features and limits, and `GET /v3/balance` returns the minutes left.

### **Step 3. Add a video**

Import a video from a link (YouTube, Google Drive or Vimeo):

```
curl -X POST https://api.rask.ai/v3/media/import \
  -H "Authorization: Bearer $RASK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://drive.google.com/file/d/1AbCdEfGhIjK/view"}'
```

The response is a **job**. Follow it until it finishes. `wait_seconds` holds the request until the job changes, so you need fewer requests:

```
curl "https://api.rask.ai/v3/jobs/JOB_ID?wait_seconds=20" \
  -H "Authorization: Bearer $RASK_API_KEY"
```

When the job status is `succeeded`, it contains the `media_id`.

To upload a local file, use `POST /v3/uploads`, send the file to the returned upload URLs, then call `POST /v3/uploads/{upload_id}/complete`. The SDKs do these steps for you.

### **Step 4. Estimate the price**

```
curl -X POST https://api.rask.ai/v3/projects/estimate \
  -H "Authorization: Bearer $RASK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media_id": "MEDIA_ID", "target_language": "es-es"}'
```

The estimate is free. It returns `eligible`, the cost of each step, `total_minutes`, your balance after the action and the remaining monthly limit of the key.

### **Step 5. Create the project and dub the video**

Send the same request to `POST /v3/projects` and add `expected_cost_minutes` with the price from the estimate:

```
curl -X POST https://api.rask.ai/v3/projects \
  -H "Authorization: Bearer $RASK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "MEDIA_ID",
    "target_language": "es-es",
    "name": "Q3 webinar",
    "expected_cost_minutes": 4
  }'
```

Rask transcribes, translates and dubs the video automatically. If the price is higher than `expected_cost_minutes`, the request fails and nothing is charged.

Follow the returned job with `GET /v3/jobs/{job_id}?wait_seconds=20`.

### **Step 6. Download the result**

```
curl https://api.rask.ai/v3/projects/PROJECT_ID/outputs \
  -H "Authorization: Bearer $RASK_API_KEY"
```

The list contains every file of the project, such as the dubbed video, with a download `url` and its `expires_at` time. Request the list again for fresh links.

### **Choose the dubbing model and the language variant**

- **Model:** add `"dubbing_model": "v2"` for [Dubbing 2.0](https://help.rask.ai/hc/what-is-meaning-first-translation-approach?hsLang=en) or `"v1"` for Dubbing 1.0. The default is `v2`. For some languages and voices, Rask uses the compatible model automatically. The estimate and the project show the model applied and the reason.
- **Language:** use the exact code from `GET /v3/languages`, for example `pt-br` for Brazilian Portuguese, or `es-mx`, `es-us`, `es-ar` and `es-co` for Latin American Spanish variants.

### **Use your own transcript or SRT**

When you already have subtitles, Rask can use them in place of speech recognition. Add `subtitles` to `POST /v3/projects`:

```
{
  "media_id": "MEDIA_ID",
  "target_language": "es-es",
  "source_language": "en",
  "subtitles": {
    "source": {
      "format": "srt",
      "content": "1\n00:00:00,000 --> 00:00:03,200\n[SPEAKER_00]: Welcome to our Q3 webinar.\n"
    }
  },
  "expected_cost_minutes": 1
}
```

| You send | What Rask does |
| --- | --- |
| `source` only | Uses your source text and translates it. `source_language` is required. |
| `source` and `target` | Uses both texts as they are. Both files need the same number of cues and the same timings. |
| `target` only | Voices your translation as it is. The source speech is transcribed within the SRT timings. |

- Mark speakers with `[SPEAKER_00]:`, `[SPEAKER_01]:` and so on at the start of a cue. Label every cue or none.
- Each file can be up to 2 MiB and 5,000 cues.
- To replace the transcript of an existing project, use `POST /v3/projects/{project_id}/transcript/import`.

### **Rate limits**

| Limit | Starting value on paid plans |
| --- | --- |
| Requests per key | 600 per minute |
| Requests per account (all keys) | 1,800 per minute |
| Requests that spend minutes, per key | 30 per minute |
| Uploads and imports, per key | 120 per hour |
| Active jobs at the same time | 10 dubs, 3 lip-sync runs, 2 on-screen text runs |

Your exact limits are in the `RateLimit-Policy` and `RateLimit` response headers. After a `429` response, wait for the time in `Retry-After`. For higher volume, contact our team.

### **Error codes**

| Code | Meaning | What to do |
| --- | --- | --- |
| `401 authentication_required` | No `Authorization: Bearer` header | Add the header. |
| `401 invalid_token` | The key is wrong or incomplete | Copy the full key again. |
| `401 token_expired` | The key has expired | Create a new key. |
| `401 token_revoked` | The key was revoked | Create a new key. |
| `401 token_wrong_environment` | The key belongs to another environment | Use a production key with `https://api.rask.ai/v3`. |
| `403 insufficient_scope` | The key lacks a permission | Create a key with the access you need. |
| `403 feature_not_in_plan` | Your plan does not include this feature | Check your plan or contact our team. |
| `403 token_spend_limit_exceeded` | The key reached its monthly limit | Raise the limit in **Settings → API keys** or wait for the next month. |
| `403 workspace_access_suspended` | The Teamspace is suspended | Contact the Teamspace owner or our support team. |

**Coming from an OAuth example?** The `client_credentials` OAuth flow belongs to API v2. API v3 uses the key from **Settings → API keys** directly in the `Authorization: Bearer` header.

### **API v2 and v3**

API v2 keeps working beside v3, and no end date for v2 is set. An existing v2 integration needs no immediate change. New integrations should use v3: it covers the whole platform, uses simple API keys and gives a price estimate for every paid action. See [Move from v2](https://docs.api.rask.ai/v3/migrate-from-v2).

### **Related articles**

- [How to connect Rask to Claude, Codex, Cursor or VS Code with MCP](https://help.rask.ai/hc/rask-mcp-server?hsLang=en)
- [Rask API SDKs: Python, TypeScript, Go, Java and PHP](https://help.rask.ai/hc/python-sdk-for-rask-api?hsLang=en)
- [How to translate on-screen text in a video](https://help.rask.ai/hc/visual-translation-on-screen-text?hsLang=en)
- [API reference](https://docs.api.rask.ai)

- [FAQs](https://help.rask.ai/hc/faqs?hsLang=en)
- [Features](https://help.rask.ai/hc/features?hsLang=en)
- [Editing projects](https://help.rask.ai/hc/editing-projects?hsLang=en)
- [Pricing plans & billing information](https://help.rask.ai/hc/pricing-plans-billing-information?hsLang=en)
- [Fix a problem](https://help.rask.ai/hc/fix-a-problem?hsLang=en)
- [Enterprise](https://help.rask.ai/hc/enterprise?hsLang=en)
- [Account questions](https://help.rask.ai/hc/account-questions?hsLang=en)
- [Changelog](https://help.rask.ai/hc/changelog?hsLang=en)

[![Rask logo](https://help.rask.ai/hubfs/642973bc6c28f475e0f8c538_rask-logo-black%20(1).svg "Rask logo")](http://brask.ai)

RASK AI Help Center

Copyright © 2026, Brask AI