# Hidream-o1-text2img

> hidream-O1 image generation model with text-to-image, image-to-image, and multi-reference capabilities.

## Overview

- **Model ID**: `hidream-o1`
- **Category**: image
- **Provider**: modelslab
- **Source Type**: Open Source Model
- **Status**: model_ready
- **Screenshot**: `https://assets.modelslab.ai/generations/8b413ab9-adab-4032-8ff5-91911074f3c5.png`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v6/images/text2img`
- **Method**: POST

### Parameters

- **`prompt`** (required): Describe the image you want to generate
  - Type: textarea
  - Example: Enter prompt

- **`negative_prompt`** (optional): Things to avoid in the generated image
  - Type: textarea
  - Example: Enter negative prompt

- **`height`** (required): Height of the generated image
  - Type: number (range: 1024-2048)

- **`width`** (required): Width of the generated image
  - Type: number (range: 1024-2048)

- **`samples`** (required): Number of images to generate
  - Type: number (range: 1-4)

- **`safety_checker`** (optional): NSFW content checker
  - Type: toggle

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v6/images/text2img \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "hidream-o1",
    "prompt": "A highly detailed 3D rendered anthropomorphic fox character in a confident hero stance, featuring vibrant orange and white fur with striking teal accent markings around the eyes and ears. The character wears a weathered brown leather adventure vest adorned with brass buckles, utility pouches, and stitched detailing. Stylized semi-realistic proportions with large expressive eyes, a sleek muzzle, and a full fluffy tail with a white tip. Rendered in a cinematic cel-shaded style with clean ink outlines, soft rim lighting, and subtle ambient occlusion. Neutral light gray studio background. Game-ready character design aesthetic inspired by modern 3D platformers. High resolution, sharp textures, professional concept art quality, 8K render.",
    "negative_prompt": "(worst quality:2), (low quality:2), blurry, nsfw",
    "height": "2048",
    "width": "2048",
    "samples": "1",
    "safety_checker": false
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v6/images/text2img",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "hidream-o1",
        "prompt": "A highly detailed 3D rendered anthropomorphic fox character in a confident hero stance, featuring vibrant orange and white fur with striking teal accent markings around the eyes and ears. The character wears a weathered brown leather adventure vest adorned with brass buckles, utility pouches, and stitched detailing. Stylized semi-realistic proportions with large expressive eyes, a sleek muzzle, and a full fluffy tail with a white tip. Rendered in a cinematic cel-shaded style with clean ink outlines, soft rim lighting, and subtle ambient occlusion. Neutral light gray studio background. Game-ready character design aesthetic inspired by modern 3D platformers. High resolution, sharp textures, professional concept art quality, 8K render.",
        "negative_prompt": "(worst quality:2), (low quality:2), blurry, nsfw",
        "height": "2048",
        "width": "2048",
        "samples": "1",
        "safety_checker": False
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v6/images/text2img", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "hidream-o1",
    "prompt": "A highly detailed 3D rendered anthropomorphic fox character in a confident hero stance, featuring vibrant orange and white fur with striking teal accent markings around the eyes and ears. The character wears a weathered brown leather adventure vest adorned with brass buckles, utility pouches, and stitched detailing. Stylized semi-realistic proportions with large expressive eyes, a sleek muzzle, and a full fluffy tail with a white tip. Rendered in a cinematic cel-shaded style with clean ink outlines, soft rim lighting, and subtle ambient occlusion. Neutral light gray studio background. Game-ready character design aesthetic inspired by modern 3D platformers. High resolution, sharp textures, professional concept art quality, 8K render.",
    "negative_prompt": "(worst quality:2), (low quality:2), blurry, nsfw",
    "height": "2048",
    "width": "2048",
    "samples": "1",
    "safety_checker": false
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Integration Options

### CLI

Install: `curl -fsSL https://modelslab.sh/install.sh | sh` or `brew install modelslab/tap/modelslab`

```bash
modelslab auth login                                    # Authenticate
modelslab models search "hidream-o1"                       # Find this model
modelslab models detail --id hidream-o1                    # Get model details
modelslab generate image --prompt "..." --model hidream-o1  # Generate with model
modelslab config set generation.default_model hidream-o1   # Set as default
```

- Website: https://modelslab.sh
- GitHub: https://github.com/ModelsLab/modelslab-cli

### MCP Servers (Model Context Protocol)

For Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible agent.

- Generation: `https://modelslab.com/mcp/v7` (API key auth, 23 tools)
- Agent Control Plane: `https://modelslab.com/mcp/agents` (Bearer token auth, 10 tools)

Claude Code config (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "modelslab-v7": {
      "url": "https://modelslab.com/mcp/v7",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

- Documentation: https://docs.modelslab.com/mcp-web-api/overview

### Agent Skills

Install skill files directly into AI coding agents:

```bash
npx skills add modelslab/skills --all                          # All skills
npx skills add modelslab/skills --skill image-generation       # Specific skill
npx skills add modelslab/skills --all -a claude-code -a cursor # Target agents
```

- GitHub: https://github.com/ModelsLab/skills
- Documentation: https://docs.modelslab.com/agent-skills

### SDKs

- Python: `pip install modelslab`
- TypeScript: `npm install modelslab`
- PHP: `composer require modelslab/modelslab`
- Go: `go get github.com/modelslab/modelslab-go`
- Dart: `dart pub add modelslab`

## Links

- [Model Playground](https://modelslab-frontend-v2-927501783998.us-east4.run.app/models/hidream-o1-text2img/hidream-o1)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)