Katechon Technology Grids API
The grids API from Katechon Technology — 7 operation(s) for grids.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/katechon-technology:katechon-technology-grids-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Katechon Arc Grids API
description: Agent-powered AI video studio
version: 1.0.0
tags:
- name: grids
paths:
/api/v1/projects/{project_name}/generate/grid/{episode}:
post:
tags:
- grids
summary: Generate Grid
description: '提交宫格图生成任务到队列，按分段分组，每组生成一张宫格图；场景数超过单张宫格
格数上限的分组切为多张，末张不足一档时落到更小档并由占位格补齐。
立即返回 grid_ids、task_ids 与两者的逐项映射。生成由 GenerationWorker 异步执行。'
operationId: generate_grid_api_v1_projects__project_name__generate_grid__episode__post
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
- name: episode
in: path
required: true
schema:
type: integer
title: Episode
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateGridRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateGridResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grid-capability:
get:
tags:
- grids
summary: Get Grid Capability
description: '当前项目的宫格档位上限。
前端批次预览据此镜像后端阶梯——预览与入队若各自判定 4K 门控，批次数会漂移。
路径不挂在 ``/grids/`` 下，避免与 ``/grids/{grid_id}`` 抢匹配。'
operationId: get_grid_capability_api_v1_projects__project_name__grid_capability_get
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GridCapabilityResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grids:
get:
tags:
- grids
summary: List Grids
description: 列出项目下所有宫格图记录。
operationId: list_grids_api_v1_projects__project_name__grids_get
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grids/{grid_id}:
get:
tags:
- grids
summary: Get Grid
description: 获取单个宫格图记录。
operationId: get_grid_api_v1_projects__project_name__grids__grid_id__get
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
- name: grid_id
in: path
required: true
schema:
type: string
title: Grid Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grids/{grid_id}/regenerate:
post:
tags:
- grids
summary: Regenerate Grid
description: 重置宫格图状态并重新入队联合图生成任务（不隐含落格，切分另行显式触发）。
operationId: regenerate_grid_api_v1_projects__project_name__grids__grid_id__regenerate_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
- name: grid_id
in: path
required: true
schema:
type: string
title: Grid Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grids/{grid_id}/split:
post:
tags:
- grids
summary: Split Grid
description: '按当前联合图切分并覆写各分镜格——唯一覆写分镜格的操作，直接执行不设确认。
逐格覆写前旧文件补登版本、覆写后登记新版本；frame_chain 中已不在剧本内的
scene id 跳过（missing_scene_ids 返回）。切坏可在分镜格的版本史逐格回滚。'
operationId: split_grid_api_v1_projects__project_name__grids__grid_id__split_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
- name: grid_id
in: path
required: true
schema:
type: string
title: Grid Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/projects/{project_name}/grids/{grid_id}/upload:
post:
tags:
- grids
summary: Upload Grid Image
description: '上传联合图替换当前宫格图。
仅做格式归一化（转 PNG、EXIF 方向矫正，不缩放不校验 rows×cols 布局，
布局正确性由用户自行负责），登记为一个新的 grids 版本；不触发切分、
不触碰任何分镜格。'
operationId: upload_grid_image_api_v1_projects__project_name__grids__grid_id__upload_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: project_name
in: path
required: true
schema:
type: string
title: Project Name
- name: grid_id
in: path
required: true
schema:
type: string
title: Grid Id
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/Body_upload_grid_image_api_v1_projects__project_name__grids__grid_id__upload_post'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
GridCapabilityResponse:
properties:
large_grid_allowed:
type: boolean
title: Large Grid Allowed
max_cell_count:
type: integer
title: Max Cell Count
type: object
required:
- large_grid_allowed
- max_cell_count
title: GridCapabilityResponse
GenerateGridRequest:
properties:
script_file:
type: string
title: Script File
scene_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Scene Ids
type: object
required:
- script_file
title: GenerateGridRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
Body_upload_grid_image_api_v1_projects__project_name__grids__grid_id__upload_post:
properties:
file:
type: string
contentMediaType: application/octet-stream
title: File
type: object
required:
- file
title: Body_upload_grid_image_api_v1_projects__project_name__grids__grid_id__upload_post
GenerateGridResponse:
properties:
success:
type: boolean
title: Success
grid_ids:
items:
type: string
type: array
title: Grid Ids
task_ids:
items:
type: string
type: array
title: Task Ids
task_ids_by_grid:
additionalProperties:
type: string
type: object
title: Task Ids By Grid
deduped:
type: boolean
title: Deduped
message:
type: string
title: Message
type: object
required:
- success
- grid_ids
- task_ids
- task_ids_by_grid
- deduped
- message
title: GenerateGridResponse
securitySchemes:
OAuth2PasswordBearer:
type: oauth2
flows:
password:
scopes: {}
tokenUrl: /api/v1/auth/token