APICK Skills

하려는 작업에 맞는 Skill 을 검색합니다. 이름·요약·분류와 기본 금액·예상 금액(포인트), 사용 건수 구간·좋아요 수·평점을 돌려줍니다. sort 로 추천·인기·많이 쓴 순서를 고를 수 있습니다. [무료]

{
  "type": "object",
  "properties": {
    "query": {
      "description": "찾으려는 작업을 나타내는 검색어",
      "type": "string",
      "maxLength": 60
    },
    "category": {
      "description": "분류",
      "type": "string",
      "enum": [
        "data",
        "ai",
        "dev",
        "document",
        "marketing",
        "finance",
        "productivity",
        "video",
        "etc"
      ]
    },
    "sort": {
      "description": "순서. recommended 추천, popular 인기, used 많이 사용, likes 좋아요순, rating 평점순, new 최신, mine 내가 자주 쓴, liked 내가 좋아요한. 생략하면 등록 순",
      "type": "string",
      "enum": [
        "recommended",
        "popular",
        "used",
        "likes",
        "rating",
        "new",
        "mine",
        "liked"
      ]
    },
    "cursor": {
      "description": "다음 페이지 커서",
      "type": "string",
      "maxLength": 20
    },
    "limit": {
      "description": "한 번에 받을 개수(최대 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Skill 의 입력·출력 형식, 기본 금액과 예상 금액, 처리 상한, 예제를 확인합니다. 실행 전에 입력 형식을 맞추는 데 씁니다. [무료]

{
  "type": "object",
  "properties": {
    "skill_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "search_skills 결과의 skill_id"
    }
  },
  "required": [
    "skill_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

실행 전 예상 금액 조회. 입력을 검사하고 이 입력으로 실행했을 때의 예상 금액(estimated_points)과 최대 금액(max_points)을 알려 줍니다. 실행하지 않으며 과금되지 않습니다. 결과는 5분 동안 유효합니다. [무료]

{
  "type": "object",
  "properties": {
    "skill_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "search_skills 결과의 skill_id"
    },
    "version": {
      "description": "버전. 생략하면 현재 게시 버전",
      "type": "string",
      "maxLength": 16
    },
    "input": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Skill 의 input_schema 에 맞는 입력 객체"
    }
  },
  "required": [
    "skill_id",
    "input"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Skill 을 실행합니다. 결과가 검증되어 반환될 때만 차감되고, 실패·시간초과·취소는 차감되지 않습니다. 차감 금액은 기본 금액에 실제 AI 사용 비용을 더한 값이며 billing.charged_points 로 알려 줍니다. 같은 idempotency_key 로 다시 보내면 새로 실행하지 않고 같은 실행을 돌려줍니다. 20초 안에 끝나지 않으면 run_id 만 돌려주므로 get_skill_run 으로 확인합니다. [실제 사용한 만큼 포인트 차감]

{
  "type": "object",
  "properties": {
    "skill_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "search_skills 결과의 skill_id"
    },
    "input": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Skill 의 input_schema 에 맞는 입력 객체"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{1,128}$",
      "description": "이 실행을 구분하는 고유 값. 재시도할 때 같은 값을 씁니다"
    },
    "version": {
      "description": "버전. 생략하면 현재 게시 버전",
      "type": "string",
      "maxLength": 16
    },
    "quote_id": {
      "description": "quote_skill 이 돌려준 번호",
      "type": "string",
      "maxLength": 40
    },
    "max_cost_points": {
      "description": "최대 금액이 이 값보다 높으면 실행하지 않습니다. 실제 차감액은 이 값을 넘지 않습니다",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "wait_seconds": {
      "description": "결과를 기다릴 시간(초). 기본 20",
      "type": "integer",
      "minimum": 0,
      "maximum": 20
    }
  },
  "required": [
    "skill_id",
    "input",
    "idempotency_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

실행 상태와 과금 상태를 확인합니다. 성공한 실행은 결과를 함께 돌려줍니다. [무료]

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "run_skill 이 돌려준 run_id"
    }
  },
  "required": [
    "run_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

아직 끝나지 않은 실행을 취소합니다. 취소된 실행은 과금되지 않습니다. 이미 끝난 실행은 취소할 수 없습니다. [무료]

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "run_skill 이 돌려준 run_id"
    }
  },
  "required": [
    "run_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}