Stability AI

Generate and upscale images using Stable Diffusion models via Stability AI.

AI and MLAPI key2 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (2)
text-to-image
custom_api_call
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("stability_ai", "text-to-image", {
    "prompt": "<prompt>",
    "engine_id": "stable-diffusion-xl-1024-v1-0"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Stability AI answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "stability-ai-text-to-image",
  name: "Stability AI: Text to Image",
  description: "Calls Stability AI when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("stability_ai", {
      "action": "text-to-image",
      "prompt": "<prompt>",
      "engine_id": "stable-diffusion-xl-1024-v1-0"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/stability_ai/text-to-image" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"prompt":"<prompt>","engine_id":"stable-diffusion-xl-1024-v1-0"}}'

Actions

text-to-imagein catalog

Text to Image. Generate an image using a text prompt

Input	Type	Description
`prompt`required	text	The text to transform in image.
`cfg_scale`optional	number	How strictly the diffusion process adheres to the prompt text (higher values keep your image closer to your prompt) (MIN:0; MAX:35)
`height`optional	number	Height of the image in pixels. Must be in increments of 64 and >= 128
`width`optional	number	Width of the image in pixels. Must be in increments of 64 and >= 128
`samples`optional	text	Number of images to generate (MAX:10)
`steps`optional	number	Number of diffusion steps to run (MIN:10; MAX:150)
`weight`optional	number	weight
`clip_guidance_preset`optional	one of "NONE" \| "FAST_BLUE" \| "FAST_GREEN" \| "SIMPLE" \| "SLOW" \| "SLOWER" \| "SLOWEST"	clip_guidance_preset
`style_preset`optional	one of "enhance" \| "anime" \| "photographic" \| "digital-art" \| "comic-book" \| "fantasy-art" \| "line-art" \| "analog-film" \| "neon-punk" \| "isometric" \| "low-poly" \| "origami"	Pass in a style preset to guide the image model towards a particular style.
`engine_id`required	one of "stable-diffusion-xl-1024-v1-0" \| "stable-diffusion-768-v2-1" \| "stable-diffusion-512-v2-1" \| "stable-diffusion-768-v2-0" \| "stable-diffusion-512-v2-0" \| "stable-diffusion-v1-5" \| "stable-diffusion-v1"	Engine ID

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

Details

Id: stability_ai
Category: AI and ML
Tags: image, stable-diffusion, generation, upscale, ai
Package: @activepieces/piece-stability-ai@0.2.4
Tier: Built in