Picsart API Platform
← All models

Ideogram P-Image

Ideogram · Image · Text → Image

Tiered Ideogram text-to-image — pick a speed/quality tier from very-low (fastest) to high (max quality).

Model ID: ideogram-p-imageWorkflow: ideogram/p-image/generate
Speed TiersUp to 2K
Try on Playground ↗

Install the SDK

The SDK targets Node 20+ and ships with TypeScript types.

npm
npm install @picsart/ai-sdk

Authenticate

Create a client once with your API key — it's sent as a bearer token on every request.

TypeScript
import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY, // sent as: Authorization: Bearer <key>
  apiUrl: 'https://api.picsart.com',
});

Run the model

Call the model with its parameters. This example uses the required ones.

TypeScript
import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

const result = await ai.generate('ideogram-p-image', {
  prompt: "A serene mountain lake at golden hour, ultra detailed",
  resolution: "1024x1024"
});

console.log(result.url); // image URL

Parameters

3 parameters. Required ones must be supplied; the rest fall back to their defaults. The API takes these same names over HTTP.

ParameterTypeRequiredDefaultDetails
prompt
Prompt
textyes
resolutionenumno1024x10242048x2048, 1440x2880, 2880x1440, 1664x2496, 2496x1664, 1792x2240, 2240x1792, 1440x2560, 2560x1440, 1600x2560, 2560x1600, 1728x2304, 2304x1728, 1296x3168, 3168x1296, 1152x2944, 2944x1152, 1248x3328, 3328x1248, 1280x3072, 3072x1280, 1024x3072, 3072x1024, 1024x1024, 896x1120, 1120x896, 864x1152, 1152x864, 832x1248, 1248x832, 800x1280, 1280x800, 720x1280, 1280x720, 720x1440, 1440x720
renderingSpeedenumnomediumvery-low, low, medium, high

Output

generate() resolves once the job completes. One or more image URLs.

Result
{
  "url": "https://cdn.picsart.com/…/result",
  "results": [
    {
      "url": "https://cdn.picsart.com/…/result"
    }
  ],
  "model": "ideogram-p-image"
}