Take1 Docs

How Take1 works, from the wallet signature to the finished video.

Overview

Take1 is an AI production studio on Solana. One account makes images, video, voice and music. Your account is your Solana wallet, you pay in SOL, and everything you make is saved to that wallet. Internet Capital Markets, the movie on our home page, was made entirely with Take1.

Quickstart

1. Open the studio and pick Phantom, Solflare or Backpack. On a phone, tapping a wallet opens the studio inside that wallet app.
2. Approve the connection and sign the login message. Signing is free and sends nothing.
3. Tap your credit balance and top up with SOL.
4. Pick Image, Video, Voice or Music, choose a model, write a prompt and hit Generate.
5. Results appear in Your takes as soon as they are ready. Tap Save to download.

Architecture

Take1 has four parts.

wallet ──sign──▶ studio ──HTTPS──▶ Take1 API ──▶ render engine
                                   │
                    Solana RPC ◀───┤  (payment checks)
                                   ▼
                            private storage ──signed link──▶ you

Wallet sign-in

Take1 uses a sign-in message, the same pattern most Solana apps use. There is no email and no password.

1. The studio asks the API for a one-time nonce for your public key.
2. Your wallet signs this message with its Ed25519 key:

Sign in to Take1

Wallet: <your public key>
Nonce: <random 128-bit value>

This does not cost anything.

3. The API checks the signature against your public key. The nonce is deleted on use and expires after 10 minutes, so a signature cannot be replayed.
4. The API returns a session token valid for 7 days. The token is bound to your wallet and signed by the server, so it cannot be edited or moved to another wallet.

Signing the login message is not a transaction. It cannot move funds, and it costs no fees.

Credits

• Credits are the unit for every generation. 100 credits is 1 USD.
• Each model has a price in credits. Video scales with length and resolution, and voice scales with the length of the text.
• The Generate button shows the estimate before you start. The exact charge is fixed when the job is accepted.
• Credits are taken when the job starts. If a job fails, the full amount goes back to your balance automatically.
• Credits do not expire.

Paying with SOL

A top-up is a normal SOL transfer from your wallet to the Take1 treasury. You approve it in your own wallet, and Take1 never holds your keys.

1. Pick an amount (0.05, 0.1, 0.25 or 0.5 SOL) and approve the transfer in your wallet.
2. The studio sends the transaction signature to the API.
3. The API reads the transaction from Solana at confirmed commitment and checks that it succeeded, that SOL moved from your wallet and to the treasury, and how many lamports moved.
4. The amount is converted at the live SOL/USD price at that moment:

credits = floor( SOL sent × SOL/USD price × 100 )

5. Each transaction signature can be counted once. Sending the same signature again returns already_used.

Credits usually arrive within a few seconds. If the network is slow, the studio says so and you can try confirming again with the same payment; it will never be counted twice.

Generation lifecycle

Job states: running, done, failed. A failed job is refunded in full.

Models and prices

Live from the API. Prices are the starting price in credits for the shortest length and lowest resolution.

API reference

Base URL:

https://take1.video/api

Requests and responses are JSON. Pick the action with ?a=. Signed-in actions need the session token:

Authorization: Bearer <token>

GET ?a=models

Public. Lists every model with its options and starting price.

{
  "models": [
    { "id": "cinema-studio-4", "title": "Take1 Studio", "kind": "video",
      "durations": [4, 5, ... 15], "resolutions": ["480p", "720p"],
      "aspects": ["16:9", "9:16", ...], "credits": 524 }
  ],
  "treasury": "<address>",
  "credits_per_usd": 100
}

POST ?a=nonce

// request
{ "wallet": "<public key>" }
// response
{ "message": "Sign in to Take1\n\nWallet: ...\nNonce: ...\n\nThis does not cost anything." }

POST ?a=verify

// request: signature of the exact message, base64
{ "wallet": "<public key>", "signature": "<base64>" }
// response
{ "token": "<session token>" }

GET ?a=me token

Your balance and your latest 40 jobs, each with a fresh signed link when done.

{ "wallet": "...", "credits": 1250,
  "jobs": [ { "id": "...", "kind": "video", "model": "veo-3.1", "prompt": "...",
              "status": "done", "credits": 436, "url": "https://..." } ] }

POST ?a=topup token

// request: signature of your SOL transfer to the treasury
{ "signature": "<transaction signature>" }
// response
{ "credits": 1840, "balance": 3090, "sol_usd": 184.2 }

POST ?a=gen token

// request
{ "model": "seedance-2.5", "prompt": "Handheld, a trader alone at his desk at night, monitor glow",
  "aspect": "9:16", "duration": 8, "resolution": "720p" }
// response
{ "id": "<job id>", "credits": 342, "balance": 2748 }

Fields a model does not support are ignored and fall back to that model's default. Voice models take voice and read the prompt aloud. Prompts are limited to 3,000 characters (4,000 for voice).

Errors

Errors come back as { "error": "<code>" } with an HTTP status.

Security

• Take1 only ever asks your wallet for two things: the free login signature and a plain SOL transfer you approve.
• Take1 never sees or stores private keys or seed phrases. Never type them anywhere.
• Payments are verified on chain, not trusted from the browser.
• Balance changes happen in single database steps, so a balance cannot go below zero or be spent twice.
• Sessions last 7 days. Disconnect from the studio menu to end one early.

Privacy

• No email, no name, no password. Your account is your public key.
• Your prompts and results are private to your wallet. There is no public feed.
• Files are only reachable through signed links that expire after 1 hour.