---
title: "Provision an instant sandbox (pv_test_) key — no auth, no card"
method: POST
path: "/v1/sandbox"
tags: ["provisioning"]
---

# Provision an instant sandbox (pv_test_) key — no auth, no card

`POST /v1/sandbox`

## Request

- Base URL: `https://api.primateintelligence.ai`
- URL: `https://api.primateintelligence.ai/v1/sandbox`
- Auth: none declared

Anonymous zero-touch provisioning (A1). Issues a fixture-only test-mode key: analyses return deterministic canned results, never touch the GPU, and burn no credits. IP-limited; 7-day expiry. Live keys require signup (billing gate, not an integration gate).

## Response `201`

Sandbox key issued. The raw key appears only in this response.

- SandboxKey
  - `object` 'sandbox_key', required
  - `api_key` string, required: Shown exactly once — store it now. Fixture-only test mode: no GPU, no credits.
  - `mode` 'test', required
  - `expires_at` string, required: Keys expire 7 days after issuance.
  - `fixture_video_id` string, nullable, required: Pre-seeded ready video for immediate POST /v1/analyses.
  - `fixture_prompt` string, required
  - `expected_answer` string, required: Deterministic canned answer for the fixture prompt — assert this in CI.
  - `docs_url` string, required
  - `note` string, required

## Other responses

- `429`: sandbox_limit_exceeded — IP daily cap reached. Retry-After set.
- `503`: db_unavailable — transient; retry with backoff.

---

[API](https://skmtc.dev/primateintelligence/apis/primate-vision-api.md) · [All operations](https://skmtc.dev/primateintelligence/apis/primate-vision-api/llms.txt) · [OpenAPI document](https://skmtc.dev/primateintelligence/apis/primate-vision-api/revisions/aa51b01dc8ad?raw)