Source: https://docs.sogni.ai/agents/first-result/

# Your first agent image

Use a terminal agent with Node.js 22.11 or newer. The steps below use the published Sogni installer and CLI. Installation, authenticated access and successful generation are separate checks.

## [#](https://docs.sogni.ai/agents/first-result/#install)Install

Start your agent once so its configuration directory exists, then run:

```
npx setup-sogni-agent-skill
```

Follow the installer prompts to configure Claude Code, Codex, Hermes or Claude Desktop. Sign in or create your account at [the Sogni dashboard](https://dashboard.sogni.ai/?source=agent-docs) and provide your key through the installer's credential prompt. See [authentication](https://docs.sogni.ai/agents/authentication/) for storage and account setup.

Restart the agent after installation. Run these independently:

```
sogni-agent --version
```

```
sogni-agent doctor --json
```

Require `success: true` **and** an `auth` check with `status: "pass"`. Network warnings can leave the overall doctor result successful without verifying access. Read any funding or subscription warnings before continuing.

## [#](https://docs.sogni.ai/agents/first-result/#choose-a-model-and-funding)Choose a model and funding

```
sogni-agent --list-models --model-media image --json
```

This is model discovery, not an account eligibility or price guarantee. Check [pricing and funding](https://docs.sogni.ai/agents/pricing/) before generating. Free API eligibility can differ from the browser apps; Krea 2 Turbo is the documented restricted-free API option as of September 2026. Use the returned model information and the account's admission response if conditions have changed.

## [#](https://docs.sogni.ai/agents/first-result/#create-one-image)Create one image

After confirming the selected model is eligible and authorizing its cost, ask your agent:

```
Create one image of a friendly robot painting a mural using Sogni.
Check my access, model eligibility and expected cost first. Tell me which
balance will pay. If I need to fund my account, pause and explain the next
step. Save the image in this project and report the model and render time.
```

For an account eligible to use Krea 2 Turbo with Spark, the direct command is:

```
sogni-agent --model krea2_turbo_fp8_scaled --token-type spark -o ./first-sogni-image.png "a friendly robot painting a mural"
```

This command submits real work and can spend your account's Spark. It is not a free dry run. A listed model or a positive total Spark balance alone does not establish funding eligibility.

Open the saved image at its native size. Check that it matches the request, and record setup time separately from queue and render time. If the request fails, inspect its error and any returned job handle before submitting again. For resumable multi-step work, use [durable jobs](https://docs.sogni.ai/agents/jobs/).