Artefaktum

List the projects of the paying wallet's account. Returns {items: [{id, name, slug, created_at}]}. Call this first: uploads, listings and search need a project_id. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Get one artifact: title, description, tags, metadata, status, expiry and latest version. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

List every version of an artifact: filename, content type, size, sha256 and status. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Store a file for 30 days: returns a presigned PUT URL for its bytes. Body: project_id (from GET /v1/projects), filename, content_type, size_bytes, title; optional tags, metadata, external_key. Price by size_bytes: $0.01 up to 10 MiB, $0.05 up to 100 MiB, $0.50 up to 1 GiB. After the PUT, POST /v1/artifacts/{id}/versions/{version_id}/complete (free, sign-in-with-x). No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

List the artifacts (stored files with title, tags, metadata and latest version) in one of the wallet's projects, newest first, filterable by status, content_type, tag, external_key and dates. Returns {items, next_cursor}. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Search the artifacts in one of the wallet's projects by meaning and by text (mode hybrid, semantic, text or exact), with filters on content type, tags, status and dates. Body: project_id, query. Returns {items: [{artifact, score, match_mode}], next_cursor, mode}. Costs $0.01 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Get a short-lived presigned URL to download an artifact's bytes (the latest version, or version_id). Returns {url, method, expires_at, version_id}. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Keep an artifact the wallet owns for another 30 days, counted from its current expiry or from now, whichever is later. No body. Costs the upload price of everything the artifact holds ($0.01 up to 10 MiB, $0.05 up to 100 MiB, $0.50 up to 1 GiB). Returns the artifact with its new expires_at. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

List an artifact's lineage: the artifacts it was derived from and those derived from it, with relation type and direction. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Store a new version of an artifact the wallet owns, kept for 30 days: returns a presigned PUT URL for its bytes. Body: filename, content_type, size_bytes. Price by size_bytes: $0.01 up to 10 MiB, $0.05 up to 100 MiB, $0.50 up to 1 GiB. After the PUT, POST /v1/artifacts/{id}/versions/{version_id}/complete (free, sign-in-with-x). No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Look up an artifact by the external_key it was stored under (your own name for it, slashes allowed), in one of the wallet's projects. max_age_seconds turns an artifact older than that into a 404, for caching. Returns the artifact. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Look up an artifact by the external_key it was stored under (your own name for it, slashes allowed), in one of the wallet's projects. max_age_seconds turns an artifact older than that into a 404, for caching. Returns the artifact. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

Look up an artifact by the external_key it was stored under (your own name for it, slashes allowed), in one of the wallet's projects. max_age_seconds turns an artifact older than that into a 404, for caching. Returns the artifact. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.