Your AI agent.
Your 3D studio.

Create an API key

Name this connection, set its total credit allowance, then copy the new key. Existing keys cannot be revealed again; revoke a lost key and create a replacement.

Keys can access your images, artwork and models, generate 2D artwork from text, create 3D models, and delete uploaded images and models. They cannot buy credits or manage your account. Each key expires after 90 days. Revoking a key prevents new requests; models already processing continue.

Your connections

API workflow

Send Authorization: Bearer YOUR_KEY on every request to https://hajimete3d.com. Keep keys on your server, never in public browser code.

1. POST /api/v1/images/upload — raw PNG/JPEG bytes, matching Content-Type and X-Content-Rights: confirmed. Maximum 5,000,000 bytes, 16–4096 pixels per side.
2. POST /api/v1/models/quote — JSON {"sourceID":"UPLOAD_ID"}. Check cost and balance, and get approval before spending. Quotes expire after five minutes.
3. POST /api/v1/models/create — JSON {"quoteID":"QUOTE_ID"}, with a unique Idempotency-Key (UUID). Reuse that same key and quote on retries.
4. GET /api/v1/models/ID/status — check every 15 seconds. Jobs continue after you disconnect.
5. GET /api/v1/models/ID/asset — download the GLB when state is succeeded. Authentication remains required.

OpenAPI reference · Download MCP connector

Text description → artwork → 3D

Your text-generated artwork appears in the same collection as web and iOS creations. Use the same private Bearer key on every request.

1. POST /api/v1/artworks/quote with the description, style and quality. Prompts must be 10–1,000 characters. Styles: anime, clay, plush, painted or asset. Standard costs 1 credit; Premium costs 4.
2. Show the returned prompt and cost to the user. The quote binds that description and expires in five minutes.
3. After approval, POST /api/v1/artworks/create with {"quoteID":"QUOTE_ID"} and a UUID Idempotency-Key. Allow up to 120 seconds for the response. Reuse the exact same quote and UUID after any timeout; do not start a new paid request.
4. Use GET /api/v1/artworks/JOB_ID/status to check a job, or GET /api/v1/artworks to find your saved artwork. Follow nextCursor with ?before=CURSOR for older entries. Poll every 15 seconds or slower.
5. Download the image from GET /api/v1/artworks/JOB_ID/asset. The same key is required.
6. To make it 3D, pass the succeeded artwork’s sourceID to POST /api/v1/models/quote. Review the separate 12-credit price before creating the model.

Example: quote a text description

curl https://hajimete3d.com/api/v1/artworks/quote \
  -H "Authorization: Bearer $HAJIMETE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A tiny fox astronaut with a sunflower backpack","style":"clay","quality":"standard"}'

If a text generation is interrupted, retry with the same quote and request ID. Unfinished jobs are reconciled on the next status, list or retry request after three minutes and refunded if they could not finish. A failed image refunds both wallet credits and the key’s allowance.

Connect with MCP

This is a local connector for agents that support stdio MCP servers. There is no hosted MCP URL to paste into a remote connector field.

1. Install Node.js 22 or newer.
2. Download the Hajimete MCP connector and unzip it into a permanent folder.
3. Open a terminal in the extracted hajimete-mcp folder and run npm ci --omit=dev.
4. Create an API key above. Create folders for the images your agent may upload and the models it downloads.
5. Add the configuration below in your agent’s MCP settings. Replace all three paths with absolute paths on your computer and set your private key. Restart the agent to load its tools.

Store keys in your client’s secret settings where supported. Keep configuration containing keys out of source control.

{
  "mcpServers": {
    "hajimete": {
      "command": "node",
      "args": ["/absolute/path/to/hajimete-mcp/server.mjs"],
      "env": {
        "HAJIMETE_API_KEY": "YOUR_PRIVATE_KEY",
        "HAJIMETE_UPLOAD_DIR": "/absolute/path/to/character-images",
        "HAJIMETE_DOWNLOAD_DIR": "/absolute/path/to/model-downloads"
      }
    }
  }
}

Ask your agent to upload a character image, show you the quote, then create a 3D model after you approve spending credits. Both folders must already exist. The connector only reads images inside the upload folder you configure.

Try: “Describe a tiny fox astronaut, show me the artwork quote and create it after I approve. Then show me a separate 3D quote before making and downloading the model.”

Available tools: quote_artwork, create_artwork, list_artworks, get_artwork, get_credits, list_images, upload_image, quote_model, create_model, list_models, get_model, download_model, delete_image and delete_model. Deletions require your explicit approval.