---
title: "Generate Customized AI Content"
method: POST
path: "/v1/jobs/ai-content/custom"
---

# Generate Customized AI Content

`POST /v1/jobs/ai-content/custom`

Generates AI content based on the specified transcription job ID and parameters.

## Query parameters

- `jobId` string, required

## Request body

- object
  - `aiParts` object[], required — The AI parts to generate content for. AI parts array should have at least one AI part object, with an aiPart (title), the language to return the content for the part in, and the prompt to use.
    - `aiPart` string, required — The AI part title for the content. The AI part title must be unique for the job.
    - `language` 'ar' | 'en', required — The language to return the content for the part in. The language must be one either 'ar' or 'en'.
    - `prompt` string, required — The prompt to use for generating the content of the AI part. Please make sure to use descriptive and appropriate instructions here to get the best content possible.
  - `webhookUrl` string, uri, nullable
  - `webhookAuth` object — Authorization header to be sent in this format: `Authorization: [authKey] [authSecret]`
    - `authKey` string, nullable
    - `authSecret` string, nullable

## Response `200`

Successful response

- AiContentResponse
  - `success` boolean
  - `message` string
  - `data` object
    - `id` string
    - `title` string
    - `model` string
    - `type` 'AI_CONTENT'
    - `processingType` string
    - `webhookUrl` string
    - `totalCost` number
    - `usageTime` string
    - `mediaUrl` string, uri
    - `jobResponse` object
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED'
    - `relevantJobId` string
    - `apiKeyId` string
    - `billingId` string
    - `userId` string
    - `systemModelKey` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)