Reference

API reference

Authenticate requests, save generations, list assets, load versions, and update metadata.

Authentication

Send workspace tokens as bearer tokens. Keep tokens out of shared workflow files, screenshots, and logs whenever possible.

Authenticated request

bash

curl "$GENASSET_URL/api/v1/workspace" \
  -H "Authorization: Bearer $GENASSET_TOKEN"

Endpoints

POST/api/v1/tokensCreate an additional workspace token.

GET/api/v1/assetsList and search saved assets.

GET/api/v1/assets/{id}Read one asset with its versions.

POST/api/v1/generationsSave an image output and recipe metadata.

GET/api/v1/versions/{id}/loadLoad prompt, seed, workflow JSON, metadata, and preview URL.

PATCH/api/v1/versions/{id}/metadataMerge extra metadata onto a saved version.

Save generation

Use multipart requests when uploading image files with prompt, model, workflow JSON, and custom metadata.

Save text-to-image output

bash

curl -X POST "$GENASSET_URL/api/v1/generations" \
  -H "Authorization: Bearer $GENASSET_TOKEN" \
  -F "image=@output.png;type=image/png" \
  -F "asset_name=rain-courtyard-character" \
  -F "prompt=55mm portrait, rain-soaked courtyard, blue coat" \
  -F "model=Juggernaut XL" \
  -F "seed=530117223" \
  -F "intent=text_to_image" \
  -F "workflow_json=$(jq -c . workflow-txt2img.json)" \
  -F 'metadata={"sampler":"euler","steps":24,"cfg":5.5}'

Save image-to-image edit

bash

curl -X POST "$GENASSET_URL/api/v1/generations" \
  -H "Authorization: Bearer $GENASSET_TOKEN" \
  -F "image=@edited-output.png;type=image/png" \
  -F "asset_id=$ASSET_ID" \
  -F "prompt=keep the same character, change jacket to red leather" \
  -F "model=sdxl-inpaint" \
  -F "seed=530117224" \
  -F "intent=image_to_image" \
  -F 'metadata={"source_version_id":"'"$SOURCE_VERSION_ID"'","denoise":0.38}'

Load version

Load version recipe

bash

curl "$GENASSET_URL/api/v1/versions/$VERSION_ID/load" \
  -H "Authorization: Bearer $GENASSET_TOKEN"

Metadata

Metadata is intentionally flexible. Store sampler, steps, CFG, denoise, masks, source version IDs, control settings, or other pipeline-specific fields that matter for reproducibility.