> ## Documentation Index > Fetch the complete documentation index at: https://docs.pre.dev/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Agents: start with https://docs.pre.dev/agents.md, which has complete recipes, plan access, polling rules, errors and limits. > Authenticate with the workspace API key (pdk_…) from Integrations → Built-in, sent as Authorization: Bearer . > REST API: https://api.pre.dev (OpenAPI: https://docs.pre.dev/api-reference/openapi.json). AI Gateway: https://api.pre.dev/v1, OpenAI-compatible (OpenAPI: https://docs.pre.dev/api-reference/ai-gateway.openapi.json). > pre.dev MCP server: https://api.pre.dev/mcp. Search these docs over MCP at https://docs.pre.dev/mcp. # Get a video job > Poll a video job's status. The poll that first sees it finish charges it. ## OpenAPI ````yaml api-reference/ai-gateway.openapi.json GET /v1/videos/{jobId} openapi: 3.1.0 info: title: pre.dev AI Gateway API version: 1.0.0 description: >- One OpenAI-compatible API for hundreds of models from every major lab, paid for in pre.dev credits. - **Base URL:** `https://api.pre.dev/v1` for the OpenAI SDKs. The Anthropic SDKs take `https://api.pre.dev` and add `/v1/messages` themselves. - **Auth:** the workspace API key (`pdk_…`) from Integrations → Built-in in the pre.dev dashboard, as `Authorization: Bearer ` or `x-api-key`. Keep it on a server: it spends the workspace's credits. - **Models:** send ids exactly as `GET /v1/models` lists them, such as `anthropic/claude-sonnet-5`. - **Public directory:** `GET /v1/models/public` lists every model with no key and no prices. - **Charges:** each call is charged in credits from its metered cost. Non-streaming responses report the charge in `x-predev-credits-charged`; `GET /v1/generation` reports it for any call. A request is refused with `402` before it runs when the balance cannot cover it. Catalog, usage, generation and file reads are free. - **Limits:** 600 requests per minute per workspace, 30 on the free trial. A free workspace can spend 5 credits on AI calls in total, then gets `402 subscription_required`. Reads other than `GET /v1/files` do not count toward the per-minute limit. - **Errors:** errors raised by pre.dev use the OpenAI error shape with a `predev` object (`GatewayError`). Errors from the model keep their HTTP status and message (`ModelError`). Every inference response carries `x-predev-request-id`. - **Streaming:** `stream: true` returns server-sent events in the native format of each endpoint. Lines that start with `:` are keep-alives. Example values are illustrative. contact: name: pre.dev Support url: https://pre.dev email: support@pre.dev license: name: Proprietary url: https://pre.dev/terms servers: - url: https://api.pre.dev description: Production security: - apiKeyAuth: [] - xApiKey: [] tags: - name: Chat description: Chat completions, text completions, Responses and Messages. - name: Embeddings description: Embeddings and rerank. - name: Images and video description: Image generation and asynchronous video jobs. - name: Audio description: Speech, music and transcription. - name: Files description: Documents stored for later chat requests. - name: Models description: The model catalog, with credit prices. - name: Usage description: Usage totals and per-call stats. paths: /v1/videos/{jobId}: get: tags: - Images and video summary: Get a video job description: >- Reports a video job's status. Use the job's `id` from the submit response; `polling_url` is this same URL. The poll that first sees the job finish charges it and returns `x-predev-credits-charged`. Jobs belong to the workspace that submitted them. operationId: getVideo parameters: - name: jobId in: path required: true schema: type: string description: >- The job's `id` from the submit response. `polling_url` ends with the same id, so polling either one works. responses: '200': description: The job. headers: x-predev-request-id: $ref: '#/components/headers/RequestId' x-predev-credits-charged: $ref: '#/components/headers/CreditsCharged' content: application/json: schema: $ref: '#/components/schemas/VideoJob' example: id: YCXWQa200sQEi5GSnlfP polling_url: https://api.pre.dev/v1/videos/YCXWQa200sQEi5GSnlfP status: completed unsigned_urls: - >- https://api.pre.dev/v1/videos/YCXWQa200sQEi5GSnlfP/content?index=0 '401': $ref: '#/components/responses/Unauthorized' '404': description: No job with this id belongs to the workspace. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: message: No video job with that id belongs to this workspace. type: not_found_error code: not_found param: null predev: {} '429': $ref: '#/components/responses/AuthFailures' '500': $ref: '#/components/responses/ServerError' components: headers: RequestId: description: >- pre.dev id for this request (`pdr_…`). Quote it when you contact support. schema: type: string example: pdr_043293a6-d1a8-4695-81fe-603ad4661ebb CreditsCharged: description: >- Credits charged for this call. Streamed responses do not carry it because the charge settles after the stream ends; read `GET /v1/generation` for those. schema: type: number example: 0.005 RetryAfter: description: Seconds to wait before retrying. schema: type: integer example: 12 schemas: VideoJob: type: object required: - id - polling_url - status properties: id: type: string description: >- Job id. Poll `GET /v1/videos/{id}` and download from `GET /v1/videos/{id}/content`. polling_url: type: string format: uri description: >- `https://api.pre.dev/v1/videos/{id}` for this job: the status URL, ending with the job's `id`. status: type: string enum: - pending - in_progress - completed - failed - cancelled - expired generation_id: type: string unsigned_urls: type: array items: type: string description: >- Present when the job has completed. Download through `GET /v1/videos/{jobId}/content`. error: type: string description: Why the job failed. additionalProperties: true GatewayError: type: object description: >- An error raised by pre.dev, in the OpenAI error shape with an extra `predev` object (absent on `catalog_unavailable` from the catalog listings). Branch on `error.code`. required: - error properties: error: type: object required: - message - type - code - param properties: message: type: string description: What went wrong and what to do next. type: type: string enum: - authentication_error - insufficient_credits - subscription_required - invalid_request_error - not_found_error - rate_limit_error - server_error description: >- Error class. The OpenAI and Anthropic SDKs map the HTTP status to their own exception types. code: type: string enum: - missing_api_key - invalid_api_key - too_many_auth_failures - insufficient_credits - subscription_required - rate_limit_exceeded - balance_unavailable - invalid_request - missing_id - not_found - not_ready - upstream_unavailable - catalog_unavailable - internal_error description: >- | Code | HTTP | Meaning | | --- | --- | --- | | `missing_api_key` | 401 | No `Authorization: Bearer` or `x-api-key` header. | | `invalid_api_key` | 401 | The key is unknown, or was rotated more than 15 minutes ago. | | `too_many_auth_failures` | 429 | More than 30 failed key attempts from this IP address in a minute. | | `insufficient_credits` | 402 | The balance is zero or below the estimate for this request. Nothing ran. | | `subscription_required` | 402 | A free workspace used its 5 credits of AI calls. | | `rate_limit_exceeded` | 429 | Over the per-minute request limit for the workspace. | | `balance_unavailable` | 503 | The balance could not be read. Nothing ran. | | `invalid_request` | 400 | `/v1/audio/speech` is missing `model` or `input`, or the model does not produce audio. | | `missing_id` | 400 | `/v1/generation` was called without `id`. | | `not_found` | 404 | Unknown path, or a file, video job, response or generation that belongs to another workspace, including one a request refers to. | | `not_ready` | 404 or 502 | Generation stats are not available yet. | | `upstream_unavailable` | 502 | The model did not answer, or returned no audio. | | `catalog_unavailable` | 502 or 503 | The model catalog could not be read: 502 from the catalog listings, 503 from `GET /v1/models/public`. Retry shortly. | | `internal_error` | 500 | Unexpected error. | param: type: 'null' predev: $ref: '#/components/schemas/GatewayErrorDetails' GatewayErrorDetails: type: object description: Extra fields for some error codes; an empty object for the rest. properties: credits_remaining: type: number description: >- Workspace balance. Sent with `insufficient_credits` and `subscription_required`. estimated_credits: type: number description: >- Estimated credits the request needs. Sent with `insufficient_credits`. trial_credits_used: type: number description: >- Credits the free trial has spent on AI calls. Sent with `subscription_required`. topup_url: type: string format: uri description: Where to add credits or subscribe. retry_after: type: integer description: Seconds to wait. Also sent as the `Retry-After` header. available_models: type: array items: type: string description: >- Speech and music model ids. Sent with `invalid_request` from `/v1/audio/speech`. responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/GatewayError' examples: missing_api_key: summary: No key sent value: error: message: >- Send your pre.dev API key as `Authorization: Bearer ` or `x-api-key`. Copy it from Integrations → Built-in: https://pre.dev/projects/integrations type: authentication_error code: missing_api_key param: null predev: {} invalid_api_key: summary: Unknown or retired key value: error: message: Invalid API key type: authentication_error code: invalid_api_key param: null predev: {} AuthFailures: description: >- More than 30 failed key attempts from this IP address in the current minute. headers: Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: message: >- Too many failed API key attempts from this address. Try again in a minute. type: rate_limit_error code: too_many_auth_failures param: null predev: retry_after: 60 ServerError: description: Unexpected error. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: message: The pre.dev AI gateway hit an unexpected error. type: server_error code: internal_error param: null predev: {} securitySchemes: apiKeyAuth: type: http scheme: bearer bearerFormat: pdk_ API key description: >- The workspace API key (`pdk_…`) from Integrations → Built-in in the pre.dev dashboard. xApiKey: type: apiKey in: header name: x-api-key description: >- Alternative to `Authorization: Bearer`. The Anthropic SDKs send this header. ````